Element zadania target (MSBuild)

Artykuł
08/25/2023

Tworzy i wykonuje wystąpienie zadania MSBuild. Nazwa elementu jest określana przez nazwę tworzonego zadania.

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>

Share via