Udostępnij za pośrednictwem


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>

Zobacz też