MSBuild

Eigenschaften stellen Schlüssel/Wert-Paare dar, die zur Konfiguration von Builds verwendet werden können. Eigenschaften werden deklariert, indem ein Element mit dem Namen der Eigenschaft als untergeordnetes Element eines PropertyGroup-Elements erstellt wird. Beispielsweise erstellt der folgende Code eine Eigenschaft, die BuildDir genannt wird, die einen Wert aus Build verfügt.

<PropertyGroup>
    <BuildDir>Build</BuildDir>
</PropertyGroup>

Sie können eine Eigenschaft bedingt definieren, indem Sie ein Condition-Attribut im - Element einfügen. Sofern wenn die Bedingung nicht true ergibt, wird der Inhalt bedingter Elemente ignoriert. Im folgenden Beispiel wird das Configuration-Element definiert, wenn es noch nicht definiert wurde.

<Configuration  Condition=" '$(Configuration)' == '' ">Debug</Configuration>

Auf Eigenschaften wird in der gesamten Projektdatei mit der Syntax %(PropertyName) verwiesen. Beispielsweise können Sie die Eigenschaften in den vorherigen Beispielen verweisen, indem Sie $(BuildDir) und $(Configuration) verwenden.

Weitere Informationen zu Eigenschaften finden Sie unter MSBuild-Eigenschaften.

Elemente sind Eingaben in das Buildsystem und stellen in der Regel Dateien dar. Elemente werden auf der Grundlage benutzerdefinierter Elementnamen in Elementtypen gruppiert. Diese Elementtypen können als Parameter für Aufgaben verwendet werden, die mithilfe der einzelnen Elemente die Schritte des Buildprozesses ausführen.

Elemente werden in der Projektdatei deklariert, indem ein Element mit dem Namen des Elementtyps als untergeordnetes Element eines ItemGroup-Elements erstellt wird. Im folgenden Code wird z. B. der Elementtyp Compile mit zwei Dateien erstellt.

<ItemGroup>
    <Compile Include = "file1.cs"/>
    <Compile Include = "file2.cs"/>
</ItemGroup>

Auf Elementtypen wird in der gesamten Projektdatei mit der Syntax @(ItemType) verwiesen. Auf den Elementtyp im Beispiel wird beispielsweise mit @(Compile) verwiesen.

In MSBuild sind Element- und Attributnamen beachtet. Allerdings sind Eigenschaft, Elementen und Metadaten nicht. Das folgende Beispiel erstellt den Elementtyp Compile, comPile oder ein anderes Fallvariante und gibt dem Elementtyp den Wert "one.cs; two.cs".

<ItemGroup>
  <Compile Include="one.cs" />
  <comPile Include="two.cs" />
</ItemGroup>

Elemente können mit Platzhalterzeichen deklariert werden und zusätzliche Metadaten für erweiterte Buildszenarios enthalten. Weitere Informationen zu Elementen finden Sie unter MSBuild-Elemente.

Aufgaben sind Einheiten ausführbaren Codes, die in MSBuild-Projekten zum Ausführen von Buildvorgängen verwendet werden. Eine Aufgabe kann beispielsweise Eingabedateien kompilieren oder ein externes Tool ausführen. Aufgaben können wiederverwendet werden, auch von verschiedenen Entwicklern in unterschiedlichen Projekten.

Die Ausführungslogik einer Aufgabe wird in verwaltetem Code geschrieben und MSBuild über das UsingTask-Element zugeordnet. Sie können eine eigene Aufgabe schreiben, indem Sie einen verwalteten Typ erstellen, der die ITask-Schnittstelle implementiert. Weitere Informationen zum Erstellen von Aufgaben finden Sie unter Schreiben von Aufgaben.

MSBuild umfasst häufige Aufgaben, die Sie ändern können, um den Anforderungen anpassen. Beispiele sind Kopie, das Dateien, MakeDir, das Verzeichnisse erstellt und Csc kopiert, das Visual C#quellcodedateien kompiliert. Eine vollständige Liste der verfügbaren Aufgaben sowie zugehörige Verwendungsinformationen finden Sie unter Referenz zu MSBuild-Aufgaben.

Eine Aufgaben wird in einer MSBuild-Projektdatei ausgeführt, indem Sie ein Element mit dem Namen der Aufgabe als untergeordnetes Element eines Target-Elements erstellen. Die meisten Aufgaben akzeptieren Parameter, die als Attribute des Elements übergeben werden. Als Parameter können Eigenschaften und Elemente von MSBuild verwendet werden. Im folgenden Code wird beispielsweise die MakeDir-Aufgabe aufgerufen und der im vorangehenden Beispiel deklarierte Wert der BuildDir-Eigenschaft an sie übergeben.

<Target Name="MakeBuildDirectory">
    <MakeDir  Directories="$(BuildDir)" />
</Target>

Weitere Informationen zu Aufgaben finden Sie unter MSBuild-Aufgaben.

Durch Ziele werden Aufgaben in einer bestimmten Reihenfolge gruppiert und Abschnitte der Projektdatei als Einstiegspunkte in den Buildprozess verfügbar gemacht. Ziele werden häufig in logischen Abschnitten, die Lesbarkeit zu verbessern gruppiert und Erweiterungen zu ermöglichen. Wenn die Buildschritte in Ziele unterteilt werden, können Sie einen Teil des Buildprozesses in anderen Zielen aufrufen, ohne diesen Codeabschnitt in jedes Ziel kopieren zu müssen. Wenn mehrere Einstiegspunkte in den Buildprozess Verweisen erfordern erstellt werden, können Sie ein Ziel erstellen, das Verweise erstellt und dieses Ziel anschließend über jeden Einstiegspunkt aus, in dem es benötigt hat.

Ziele werden in der Projektdatei mit dem Target-Element deklariert. Im folgenden Code wird beispielsweise das Ziel Compile erstellt, durch das anschließend die Csc-Aufgabe mit der im vorangehenden Beispiel deklarierten Elementliste aufgerufen wird.

<Target Name="Compile">
    <Csc Sources="@(Compile)" />
</Target>

In fortgeschritteneren Szenarios können Ziele verwendet werden, um Beziehungen unter miteinander zu beschreiben und Abhängigkeitsanalysen durchführen, damit ganze Bereiche des Buildprozesses übersprungen werden können, wenn dieses Ziel aktuell ist. Weitere Informationen zu Zielen finden Sie unter MSBuild-Ziele.