MSBuild Task

MSBuild

Description

Runs the MSBuild build tool presented at the 2003 PDC. This task is completely untested as the developers have no access to the tool, it has been implemented by looking at the docs only.

You can either use an existing build file or nest a build file (snippet) as a child into the task. If you don't specify either, MSBuild's default build file search algorithm will apply.

Parameters

Attribute	Description	Required
buildfile	External build file to invoke MSBuild on.	No.
vm	Same as dotnetexec's vm attribute. Specify the framework to use.	No.

Parameters specified as nested elements

target

target has a single required attribute name - specifies a target to be run.

property

property has two required attributes. name and value that specify name and value of a property that is to be defined in the MSBuild invocation.

build

This element allows no attributes. You can nest a MSBuild build file into it and MSBuild will be executed on that. You can also nest a build file snippet instead and Ant will wrap the necessary MSBuild <Project> around it.

Examples

Let MSBuild search for a *.proj file in the (Ant) project's base directory and execute the default target in it:

<msbuild/>

Let MSBuild execute the targets named foo and bar in the build file msbuild.proj in Ant's basedir and pass the property /property:test=testvalue to it:

      <msbuild buildfile="msbuild.proj">
        <target name="foo"/>
        <target name="bar"/>
        <property name="test" value="testvalue"/>
      </msbuild>

Define a build file embeded into the task, let MSBuild execute the echo target of that build file.

      <msbuild>
        <target name="echo">
        <build>
          <Project DefaultTargets="empty">
            <Target Name="empty"/>
            <Target Name="echo">
              <Task Name="Echo" Message="This is MSBuild"/>
            </Target>
          </Project>
        </build>
      </msbuild>

Run MSBuild's Echo task (if there actually is one):

      <msbuild>
        <build>
          <Task Name="Echo" Message="This is MSBuild"/>
        </build>
      </msbuild>