Task – element target (MSBuild)

Vytvoří a spustí instanci MSBuild úlohy. Název elementu je určen názvem vytvářené úlohy.

<Project> <Target>

Syntax

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut Popis
Condition Nepovinný atribut. Podmínka, která se má vyhodnotit. Další informace najdete v tématu Podmínky.
ContinueOnError Nepovinný atribut. Může obsahovat jednu z následujících hodnot:

- WarnAndContinue nebo true. Když úloha selže, další úlohy v elementu Target a sestavení se budou dál spouštět a všechny chyby z úlohy se budou považovat za upozornění.
- ErrorAndContinue. Když úloha selže, další úlohy v elementu a sestavení se budou dál spouštět a všechny chyby z úlohy se budou Target považovat za chyby.
- ErrorAndStop nebo false (výchozí) Pokud úloha selže, zbývající úkoly v elementu a sestavení se neprovede a celý prvek a sestavení se považují za Target Target neúspěšné.

Verze rozhraní .NET Framework verze 4.5 podporovaly pouze true hodnoty false a .

Další informace najdete v tématu Postupy: Ignorování chyb v úlohách.
Parameter Vyžaduje se, pokud třída úlohy obsahuje jednu nebo více vlastností označených [Required] atributem .

Uživatelem definovaný parametr úlohy, který obsahuje hodnotu parametru jako hodnotu. V elementu může být libovolný počet parametrů, u každého atributu je mapování Task na vlastnost .NET ve třídě úlohy.

Podřízené prvky

Element Popis
Výstup Ukládá výstupy úkolu do souboru projektu. V úkolu může být Output nula nebo více prvků.

Nadřazené prvky

Element Popis
Cíl Element kontejneru pro MSBuild úlohy.

Poznámky

Prvek v souboru MSBuild vytvoří instanci úkolu, nastaví pro něj vlastnosti Task a spustí ji. Element Output uloží výstupní parametry ve vlastnostech nebo položkách, které se mají použít jinde v souboru projektu.

Pokud jsou v nadřazeném prvku úlohy nějaké elementy OnError, budou vyhodnoceny i v případě, že úloha selže a má Target hodnotu ContinueOnError false . Další informace o úlohách najdete v tématu Úlohy.

Příklad

Následující příklad kódu vytvoří instanci třídy úlohy Csc, nastaví šest vlastností a spustí úlohu. Po spuštění se hodnota vlastnosti objektu umístí do seznamu OutputAssembly položek s názvem 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>

Viz také