Compiles all of the projects in test.sln, in release mode, in the proper order.

<solution configuration="release" solutionfile="test.sln" />

Compiles all of the projects in projects.txt, in the proper order.

    <solution configuration="release">
    <projects>
        <includesfile name="projects.txt" />
   </projects>
</solution>

Compiles projects A, B and C, using the output of project X as a reference.

    <solution configuration="release">
    <projects>
        <include name="A\A.csproj" />
        <include name="B\b.vbproj" />
        <include name="C\c.csproj" />
    </projects>
    <referenceprojects>
        <include name="X\x.csproj" />
    </referenceprojects>
</solution>

Compiles all of the projects in the solution except for project A.

    <solution solutionfile="test.sln" configuration="release">
    <excludeprojects>
        <include name="A\A.csproj" />
    </excludeprojects>
</solution>

Compiles all of the projects in the solution mapping the specific project at http://localhost/A/A.csproj to c:\inetpub\wwwroot\A\A.csproj and any URLs under http://localhost/B/[remainder] to c:\other\B\[remainder]. This allows the build to work without WebDAV.

    <solution solutionfile="test.sln" configuration="release">
    <webmap>
        <map url="http://localhost/A/A.csproj" path="c:\inetpub\wwwroot\A\A.csproj" />
        <map url="http://localhost/B" path="c:\other\B" />
    </webmap>
</solution>

Compiles all of the projects in the solution placing compiled outputs in c:\temp.

<solution solutionfile="test.sln" configuration="release" outputdir="c:\temp" />

This task support the following projects:

• Visual Basic .NET
• Visual C# .NET
• Visual J# .NET
• Visual C++ .NET

The NAnt.VSNet.Tasks.SolutionTask also supports the model of referencing projects by their output filenames, rather than referencing them inside the solution. It will automatically detect the existence of a file reference and convert it to a project reference. For example, if project "A" references the file in the release output directory of project "B", the NAnt.VSNet.Tasks.SolutionTask will automatically convert this to a project dependency on project "B" and will reference the appropriate configuration output directory at the final build time (ie: reference the debug version of "B" if the solution is built as debug).

Resx Files

When building a project for a down-level target framework, special care should be given to resx files. Resx files (can) contain references to a specific version of CLR types, and as such are only upward compatible.

For example: if you want to be able to build a project both as a .NET 1.0 and .NET 1.1 assembly, the resx files should only contain references to .NET 1.0 CLR types. Failure to do this may result in a System.InvalidCastException failure at runtime on machines with only the .NET Framework 1.0 installed.