Task-Element (MSBuild)

Artikel
06/09/2015

Erstellt eine Instanz einer MSBuild-Aufgabe und führt diese aus. Der Elementname wird durch den Namen der Aufgabe bestimmt, die erstellt wird.

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Description
Condition	Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter MSBuild-Bedingungen.
ContinueOnError	Optionales Attribut. Kann einen der folgenden Werte enthalten: WarnAndContinue oder true. Wenn eine Aufgabe fehlschlägt, werden folgende Aufgaben im Ziel-Element und im Build fort, um auszuführen, und alle Fehler von der Aufgabe werden als Warnungen behandelt. ErrorAndContinue. Wenn eine Aufgabe fehlschlägt, werden folgende Aufgaben im Target-Element und im Build fort, um auszuführen, und alle Fehler von der Aufgabe werden als Fehler behandelt. ErrorAndStop oder false (Standard). Wenn eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Target-Element und im Build nicht ausgeführt, und das gesamte Target-Element und der Build wird angenommen fehlgeschlagen sein. .NET Framework-Versionen vor 4,5 unterstützten nur die true und false-Werte. Weitere Informationen finden Sie unter Gewusst wie: Ignorieren von Fehlern in Aufgaben.
Parameter	Erforderlich, wenn die Aufgabenklasse eine oder mehrere Eigenschaften mit dem [Required]-Attribut enthält. Ein benutzerdefinierter Aufgabenparameter, dessen Wert dem Parameterwert entspricht. Das Task-Element kann beliebig viele Parameter enthalten, wobei jedes Attribute einer .NET-Eigenschaft in der Aufgabenklasse zugeordnet wird.

Condition

Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter MSBuild-Bedingungen.

ContinueOnError

Optionales Attribut. Kann einen der folgenden Werte enthalten:

WarnAndContinue oder true. Wenn eine Aufgabe fehlschlägt, werden folgende Aufgaben im Ziel-Element und im Build fort, um auszuführen, und alle Fehler von der Aufgabe werden als Warnungen behandelt.
ErrorAndContinue. Wenn eine Aufgabe fehlschlägt, werden folgende Aufgaben im Target-Element und im Build fort, um auszuführen, und alle Fehler von der Aufgabe werden als Fehler behandelt.
ErrorAndStop oder false (Standard). Wenn eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Target-Element und im Build nicht ausgeführt, und das gesamte Target-Element und der Build wird angenommen fehlgeschlagen sein.

.NET Framework-Versionen vor 4,5 unterstützten nur die true und false-Werte.

Weitere Informationen finden Sie unter Gewusst wie: Ignorieren von Fehlern in Aufgaben.

Parameter

Erforderlich, wenn die Aufgabenklasse eine oder mehrere Eigenschaften mit dem [Required]-Attribut enthält.

Ein benutzerdefinierter Aufgabenparameter, dessen Wert dem Parameterwert entspricht. Das Task-Element kann beliebig viele Parameter enthalten, wobei jedes Attribute einer .NET-Eigenschaft in der Aufgabenklasse zugeordnet wird.

Untergeordnete Elemente

Element	Description
Ausgabe	Speichert die Ausgaben der Aufgabe in der Projektdatei. Es kann keine oder mehrere Output-Elemente in einer Aufgabe geben.

Übergeordnete Elemente

Element	Description
Target	Containerelement für MSBuild-Aufgaben.

Hinweise

Ein Task-Element in einer MSBuild-Projektdatei erstellt eine Instanz einer Aufgabe, legt entsprechende Eigenschaften fest und führt die Aufgabe aus. Das Output-Element speichert Ausgabeparameter in Eigenschaften oder Elementen, die an anderer Stelle in der Projektdatei verwendet werden sollen.

Wenn das übergeordnete Target-Element einer Aufgabe OnError-Elemente enthält, werden diese auch ausgewertet, falls die Aufgabe fehlschlägt und ContinueOnError den Wert false aufweist. Weitere Informationen zu Aufgaben finden Sie unter MSBuild-Aufgaben.

Beispiel

Im folgenden Codebeispiel wird eine Instanz der Csc task-Aufgabe erstellt, dann werden sechs Eigenschaften festgelegt, und die Aufgabe wird ausgeführt. Nach der Ausführung wird der Wert der OutputAssembly-Eigenschaft des Objekts in eine Elementliste mit dem Namen FinalAssemblyName eingefügt.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

Siehe auch

Konzepte

MSBuild-Aufgaben

Referenz zum MSBuild-Projektdateischema

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben

Freigeben über