Task – element Target (MSBuild)

  • Článek

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

<Cíl projektu><>

Syntaxe

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

Atributy a prvky

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 naleznete v tématu Podmínky.
ContinueOnError Nepovinný atribut. Může obsahovat jednu z následujících hodnot:

- WarnAndContinue nebo true. Pokud úloha selže, následné úkoly v cílovém prvku a sestavení budou pokračovat v provádění a všechny chyby z úkolu se považují za upozornění.
- ErrorAndContinue. Pokud úloha selže, následné úkoly v elementu Target a sestavení budou pokračovat v provádění a všechny chyby z úkolu se považují za chyby.
- ErrorAndStop nebo false (výchozí). Pokud úloha selže, zbývající úkoly v elementu Target a sestavení se nespustí a celý Target prvek a sestavení se považuje za neúspěšné.

Verze rozhraní .NET Framework před verzí 4.5 podporovaly true pouze hodnoty a false hodnoty.

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

Parametr úkolu definovaný uživatelem, který jako hodnotu parametru obsahuje hodnotu parametru. V elementu Task může být libovolný počet parametrů, přičemž každý atribut mapuje na vlastnost .NET ve třídě úloh.

Podřízené prvky

Element (Prvek) Popis
Výstup Ukládá výstupy z úkolu v souboru projektu. V úkolu může existovat nula nebo více Output prvků.

Nadřazené prvky

Element (Prvek) Popis
Cíl Element kontejneru pro úlohy MSBuild.

Poznámky

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

Pokud nadřazený prvek úkolu obsahuje nějaké prvky OnError, budou stále vyhodnoceny, pokud úkol selže a ContinueOnError má hodnotu false.Target Další informace o úkolech najdete v tématu Úkoly.

Příklad

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