Task-Element von „Target“ (MSBuild)

  • Artikel

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

<Projektziel><>

Syntax

<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 Beschreibung
Condition Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter Conditions (MSBuild-Bedingungen).
ContinueOnError Optionales Attribut. Kann einen oder mehrere der folgenden Werte enthalten:

- WarnAndContinue oder true. Wenn eine Aufgabe fehlschlägt, werden nachfolgende Aufgabe im Element Ziel und im Build weiterhin ausgeführt, und alle Fehler von der Aufgabe werden als Warnungen behandelt.
- ErrorAndContinue. Wenn eine Aufgabe fehlschlägt, werden nachfolgende Aufgabe im Element Target und im Build weiterhin ausgeführt, und alle Fehler von der Aufgabe werden als Fehler behandelt.
- ErrorAndStop oder false (Standard). Wenn eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Element Target und im Build nicht ausgeführt, und das komplette Element Target sowie der Build wird als fehlgeschlagen betrachtet.

Versionen von .NET Framework vor 4.5 unterstützten nur die Werte true und false.

Weitere Informationen finden Sie unter Vorgehensweise: Ignorieren von Fehlern in Aufgaben.
Parameter Erforderlich, wenn die Aufgabenklasse eine oder mehrere Eigenschaften enthält, die mit dem [Required]-Attribut gekennzeichnet sind.

Ein benutzerdefinierter Aufgabenparameter, der den Parameterwert als Wert enthält. Das Task-Element kann eine beliebige Anzahl von Parametern enthalten, wobei jedes Attribut einer .NET-Eigenschaft in der Aufgabenklasse zugeordnet ist.

Untergeordnete Elemente

Element Beschreibung
Ausgabe Speichert die Ausgaben der Aufgabe in der Projektdatei. Die Aufgabe kann keine oder mehrere Output-Elemente enthalten.

Übergeordnete Elemente

Element Beschreibung
Ziel 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 sie aus. Das Output-Element speichert Ausgabeparameter in Eigenschaften oder Elementen, damit sie an anderer Stelle in der Projektdatei verwendet werden können.

Auch bei OnError-Elementen im übergeordneten Target-Element einer Aufgabe werden sie ausgewertet, wenn die Aufgabe fehlschlägt und ContinueOnError den Wert false aufweist. Weitere Informationen zu Aufgaben finden Sie unter Aufgaben.

Beispiel

Das folgende Codebeispiel erstellt eine Instanz der Csc-Aufgabenklasse, legt sechs Eigenschaften fest und führt die Aufgabe aus. Nach der Ausführung wird der Wert der OutputAssembly-Eigenschaft des Objekts in eine Liste mit dem Namen FinalAssemblyName aufgenommen.

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

Weitere Informationen