Element zadania target (MSBuild)
Tworzy i wykonuje wystąpienie zadania MSBuild. Nazwa elementu jest określana przez nazwę tworzonego zadania.
<Cel projektu><>
Składnia
<Task Parameter1="Value1"... ParameterN="ValueN"
ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
Condition="'String A' == 'String B'" >
<Output... />
</Task>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.
Atrybuty
| Atrybut | opis |
|---|---|
Condition |
Atrybut opcjonalny. Warunek do oceny. Aby uzyskać więcej informacji, zobacz Warunki. |
ContinueOnError |
Atrybut opcjonalny. Może zawierać jedną z następujących wartości: - WarnAndContinue lub true. Gdy zadanie zakończy się niepowodzeniem, kolejne zadania w elemecie Target i kompilacja będą nadal wykonywane, a wszystkie błędy z zadania są traktowane jako ostrzeżenia. - ErrorAndContinue. Gdy zadanie zakończy się niepowodzeniem, kolejne zadania w elemecie Target i kompilacji będą nadal wykonywane, a wszystkie błędy z zadania są traktowane jako błędy.- ErrorAndStop lub false (wartość domyślna). Gdy zadanie zakończy się niepowodzeniem, pozostałe zadania w elemecie Target i kompilacji nie są wykonywane, a cały Target element i kompilacja są uznawane za nieudane.Wersje programu .NET Framework przed wersją 4.5 obsługiwały tylko true wartości i false .Aby uzyskać więcej informacji, zobacz Instrukcje: ignorowanie błędów w zadaniach. |
Parameter |
Wymagane, jeśli klasa zadań zawiera co najmniej jedną właściwość oznaczona atrybutem [Required] .Parametr zadania zdefiniowanego przez użytkownika, który zawiera wartość parametru jako jego wartość. W elemecie Task może istnieć dowolna liczba parametrów, z których każde mapowanie atrybutów na właściwość platformy .NET w klasie zadań. |
Elementy podrzędne
| Element | opis |
|---|---|
| Wyjście | Przechowuje dane wyjściowe z zadania w pliku projektu. W zadaniu może istnieć zero lub więcej Output elementów. |
Elementy nadrzędne
| Element | opis |
|---|---|
| Obiekt docelowy | Element kontenera dla zadań MSBuild. |
Uwagi
Element Task w pliku projektu MSBuild tworzy wystąpienie zadania, ustawia właściwości i wykonuje je. Element Output przechowuje parametry wyjściowe we właściwościach lub elementach, które mają być używane w innym miejscu w pliku projektu.
Jeśli w elemecie nadrzędnym zadania istnieją jakiekolwiek elementy OnError, będą one nadal oceniane, jeśli zadanie zakończy się niepowodzeniem i ContinueOnError ma wartość false.Target Aby uzyskać więcej informacji na temat zadań, zobacz Zadania.
Przykład
Poniższy przykład kodu tworzy wystąpienie klasy zadań Csc, ustawia sześć właściwości i wykonuje zadanie. Po wykonaniu wartość OutputAssembly właściwości obiektu jest umieszczana na liście elementów o nazwie FinalAssemblyName.
<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>