Task-Element (MSBuild)

Artikel
08/10/2011

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="true/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
Condition	Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen hierzu finden Sie unter MSBuild-Bedingungen.
ContinueOnError	Optionales Attribut. Ein Boolean-Attribut, das standardmäßig auf false festgelegt wird, wenn es nicht angegeben wird. Wenn ContinueOnError den Wert false aufweist und eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Target-Element nicht ausgeführt, und das gesamte Target-Element wird als fehlgeschlagen betrachtet. Wenn dieses Attribut true lautet, werden nachfolgende Aufgaben im Target-Element selbst dann weiter ausgeführt, wenn die aktuelle Aufgabe einen Fehler verursacht. Dabei werden alle von der Aufgabe generierten Fehler als Warnungen behandelt.
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 hierzu finden Sie unter MSBuild-Bedingungen.

ContinueOnError

Optionales Attribut. Ein Boolean-Attribut, das standardmäßig auf false festgelegt wird, wenn es nicht angegeben wird. Wenn ContinueOnError den Wert false aufweist und eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Target-Element nicht ausgeführt, und das gesamte Target-Element wird als fehlgeschlagen betrachtet.

Wenn dieses Attribut true lautet, werden nachfolgende Aufgaben im Target-Element selbst dann weiter ausgeführt, wenn die aktuelle Aufgabe einen Fehler verursacht. Dabei werden alle von der Aufgabe generierten Fehler als Warnungen behandelt.

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	Beschreibung
Output	Speichert die Ausgaben der Aufgabe in der Projektdatei. Es kann keine oder mehrere Output-Elemente in einer Aufgabe geben.

Übergeordnete Elemente

Element	Beschreibungen
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