Task — Element (MSBuild)

Tworzy i wykonuje wystąpienie MSBuild zadania.Nazwa elementu jest określona przez nazwę zadania, tworzony.

<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 elementów nadrzędnych.

Atrybuty

Atrybut	Opis
Condition	Atrybut opcjonalny.Szacowany warunek.Aby uzyskać więcej informacji, zobacz Warunki MSBuild.
ContinueOnError	Atrybut opcjonalny.Może zawierać jedną z następujących wartości: WarnAndContinue lub true.Kiedy zadanie nie powiedzie się, kolejne zadania w Cel element i budować nadal wykonać, a wszystkie błędy z zadania są traktowane jako ostrzeżenia. ErrorAndContinue.Kiedy zadanie nie powiedzie się, kolejne zadania w Target element i budować nadal wykonać, a wszystkie błędy z zadania są traktowane jako błędy. ErrorAndStop lub false (domyślnie).Kiedy zadanie zakończy się niepowodzeniem, pozostałe zadania w Target element i budować nie są wykonywane i całą Target element i budować uznaje się za nie powiodło się. Wersje.NET Framework przed 4.5, obsługiwany tylko przez true i false wartości. Aby uzyskać więcej informacji, zobacz Porady: ignorowanie błędów w zadaniach.
Parameter	Wymagane, jeśli klasa zadanie zawiera jeden lub więcej właściwości etykietą [Required] atrybut. Parametr zadania użytkownika, który zawiera wartość parametru jako jego wartość.Może być dowolną liczbą parametrów w Task element z każdego atrybutu mapowania właściwość .NET w klasie zadań.

Elementy podrzędne

Element	Opis
Dane wyjściowe	Sklepy wyjścia z zadań w pliku projektu.Może być zero lub więcej Output elementy w zadaniu.

Elementy nadrzędne

Element	Opis
Miejsce docelowe	Kontener MSBuild zadania.

Uwagi

A Task element w MSBuild plik projektu tworzy wystąpienie zadania, ustawia właściwości i uruchamia go.Output Element przechowuje parametry wyjściowe właściwości lub przedmioty do wykorzystania w innym miejscu w pliku projektu.

Jeśli są jakieś OnError elementy w obiekcie nadrzędnym Target element zadania, będą nadal oceniane, jeśli zadanie nie powiedzie się i ContinueOnError ma wartość false.Aby uzyskać więcej informacji na temat zadań, zobacz Zadania programu MSBuild.

Przykład

Poniższy przykład kodu tworzy wystąpienie Csc zadania klasy, ustawia sześciu właściwości i wykonuje zadanie.Po wykonaniu, wartość OutputAssembly właściwość obiektu jest umieszczany na liście element 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ż

Koncepcje

Zadania programu MSBuild

Odwołanie do schematu pliku projektu MSBuild

Inne zasoby

Odwołanie do zadania MSBuild