projects.all {
            projectFile.location = "vs/${name}.vcxproj"
            filtersFile.location = "vs/${name}.vcxproj.filters"
        }
        solution {
            solutionFile.location = "vs/${name}.sln"
        }
    }
}
// end::configure-locations[]

// tag::customize-project-files[]
model {
    visualStudio {
        projects.all { project ->
            projectFile.withXml {

                        solutionFile.location = file('foo.sln')
                    }
                }
            }
        """
        run "visualStudio"

        then:
        executedAndNotSkipped ":appVisualStudioSolution"
        skipped getComponentTasks("main")

        and:
        final solutionFile = solutionFile("foo.sln")

 *
 * <pre class='autoTested'>
 *  plugins {
 *      id 'visual-studio'
 *  }
 *
 *  model {
 *      visualStudio {
 *          solution {
 *              solutionFile.location = "vs/${name}.sln"
 *              solutionFile.withContent { TextProvider content -&gt;
 *                  content.asBuilder().insert(0, "# GENERATED FILE: DO NOT EDIT\n")

    String libraryPluginId = "cpp-library"

    @Override
    SolutionFile workspace(TestFile workspaceDir, String ideWorkspaceName) {
        return new SolutionFile(workspaceDir.file(ideWorkspaceName + ".sln"))
    }

    @Override
    ProjectFile project(TestFile projectDir, String ideProjectName) {
        return new ProjectFile(projectDir.file(ideProjectName + "Dll.vcxproj"))
    }

import org.gradle.work.DisableCachingByDefault;

import java.io.File;

/**
 * Task for generating a Visual Studio solution file (e.g. {@code foo.sln}).
 */
@Incubating
@DisableCachingByDefault(because = "Not made cacheable, yet")
public abstract class GenerateSolutionFileTask extends GeneratorTask<VisualStudioSolutionFile> {
    private DefaultVisualStudioSolution solution;

        def twoProject = projectFile("two/twoDll.vcxproj")
        def utilProject = projectFile("util/utilDll.vcxproj")
        def otherProject = projectFile("other/other.vcxproj")

        final mainSolution = solutionFile("app.sln")
        mainSolution.assertHasProjects("one", "twoDll", "utilDll", "other")
        mainSolution.assertReferencesProject(oneProject, projectConfigurations)

    private Map<File, Set<VisualStudioProjectConfigurationMetadata>> projectConfigurations = new LinkedHashMap<>()
    private baseText

    protected String getDefaultResourceName() {
        'default.sln'
    }

    void setProjects(List<VisualStudioProjectMetadata> projects) {
        projects.each { VisualStudioProjectMetadata project ->
            this.projects[project.file] = project.name

        this.name = name;
        this.solutionFile = objectFactory.newInstance(SolutionFile.class, getName() + ".sln");
        this.location = projectLayout.file(providers.provider(new Callable<File>() {
            @Override
            public File call() {
                return solutionFile.getLocation();
            }
        }));

EndGlobal
""")
                }
            }
        }
    }
'''

        and:
        run "visualStudio"

        then:
        final solutionFile = solutionFile("app.sln")
        solutionFile.content.contains "GlobalSection(MyGlobalSection)"
        solutionFile.content.contains "Project-list: mainExe"
    }

    @ToBeFixedForConfigurationCache

[[sec:visual_studio_workspace_tasks]]
=== IDE Workspace Tasks

`__projectName__VisualStudioSolution` - link:{groovyDslPath}/org.gradle.ide.visualstudio.tasks.GenerateSolutionFileTask.html[GenerateSolutionFileTask]::
+
Generates the `.sln` file. This task is only available on the root project.

[[sec:visual_studio_project_tasks]]
=== IDE Project Tasks

[[sec:visual_studio_cpp_application_tasks]]
==== {cpp} Application Plugin Tasks