Gewusst wie: Angeben des zuerst zu erstellenden Ziels

Eine Projektdatei kann eines oder mehrere Target-Elemente enthalten, durch die definiert wird, wie das Projekt erstellt wird. Das Modul Microsoft Build Engine (MSBuild) erstellt das erste gefundene Projekt und alle Abhängigkeiten, es sei denn, die Projektdatei enthält ein DefaultTargets-Attribut oder ein InitialTargets-Attribut, oder in der Befehlszeile wird mit dem /target-Schalter ein Ziel angegeben.

Verwenden des InitialTargets-Attributs

Das InitialTargets-Attribut des Project-Elements gibt ein Ziel an, das zuerst ausgeführt wird, auch wenn in der Befehlszeile oder für das DefaultTargets-Attribut Ziele angegeben sind.

So geben Sie ein ursprüngliches Ziel an

• Geben Sie das Standardziel im InitialTargets-Attribut des Project-Elements an. Beispiel:

  <Project InitialTargets="Clean">

Sie können mehrere ursprüngliche Ziele im InitialTargets-Attribut angeben, indem Sie die Ziele nacheinander aufführen und durch Semikolons voneinander trennen. Die Ziele in der Liste werden nacheinander ausgeführt.

So geben Sie mehrere ursprüngliche Ziele an

• Listen Sie die ursprünglichen Ziele durch Semikolons getrennt im InitialTargets-Attribut des Project-Elements auf. Wenn Sie das Clean-Ziel und dann das Compile-Ziel ausführen möchten, geben Sie beispielsweise Folgendes ein.

  <Project InitialTargets="Clean;Compile">

Verwenden des DefaultTargets-Attributs

Das DefaultTargets-Attribut des Project-Elements gibt das Ziel bzw. die Ziele an, die erstellt werden, wenn in der Befehlszeile kein Ziel explizit angegeben ist. Wenn sowohl im InitialTargets-Attribut als auch im DefaultTargets-Attribut Ziele angegeben sind und in der Befehlszeile kein Ziel festgelegt ist, werden in MSBuild zuerst die im InitialTargets-Attribut angegebenen Ziele und dann die im DefaultTargets-Attribut angegebenen Ziele ausgeführt.

So geben Sie ein Standardziel an

• Geben Sie das Standardziel im DefaultTargets-Attribut des Project-Elements an. Beispiel:

  <Project DefaultTargets="Compile">

Sie können mehrere Standardziele im DefaultTargets-Attribut angeben, indem Sie die Ziele nacheinander aufführen und durch Semikolons voneinander trennen. Die Ziele in der Liste werden nacheinander ausgeführt.

So geben Sie mehrere Standardziele an

• Listen Sie die Standardziele durch Semikolons getrennt im DefaultTargets-Attribut des Project-Elements auf. Wenn Sie das Clean-Ziel und dann das Compile-Ziel ausführen möchten, geben Sie beispielsweise Folgendes ein:

  <Project DefaultTargets="Clean;Compile">

Verwenden des Schalters /target

Wenn in der Projektdatei kein Standardziel definiert wurde bzw. das Standardziel nicht verwendet werden soll, können Sie mit dem Befehlszeilenschalter /target ein anderes Ziel angeben. Die mit dem Schalter /target angegebenen Ziele werden anstelle der im DefaultTargets-Attribut festgelegten Ziele ausgeführt. Die im InitialTargets-Attribut angegebenen Ziele werden immer zuerst ausgeführt.

So verwenden Sie zuerst ein anderes Ziel als das Standardziel

• Geben Sie das Ziel mit dem Befehlszeilenschalter /target als erstes Ziel an. Beispiel:

  msbuild file.proj /target:Clean

So verwenden Sie zuerst mehrere andere Ziele als die Standardziele

• Listen Sie die Ziele durch Semikolons oder Kommas getrennt auf, indem Sie den Befehlszeilenschalter /target verwenden. Beispiel:

  msbuild <file name>.proj /t:Clean;Compile

Siehe auch

Aufgaben

Gewusst wie: Bereinigen eines Builds

Konzepte

MSBuild-Ziele

Weitere Ressourcen

MSBuild

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Juni 2010	Text geändert, um hervorzuheben, dass nur ein Projekt erstellt wird, sofern keine weiteren Projekte angegeben werden.	Korrektur inhaltlicher Fehler.