Task-Element (MSBuild)

Artikel
02/26/2013

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