Prvek Task (MSBuild)

Článek
03/04/2013

Vytvoří a spustí instance MSBuild úkolu.Název elementu je určen název úkolu je vytvořen.

<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 rodičovské prvky.

Atributy

Atribut	Description
Condition	Nepovinný atribut.Podmínka pro vyhodnocení.Další informace naleznete v tématu Nástroj MSBuild podmínky.
ContinueOnError	Nepovinný atribut.Může obsahovat jednu z následujících hodnot: WarnAndContinue nebo true.Při úlohy nezdaří, následné úlohy v cíl element a sestavení nadále spouštět a všechny chyby z úkolu jsou považovány za upozornění. ErrorAndContinue.Když úkol selže, následné úkoly v Target element a sestavení nadále spouštět a všechny chyby z úkolu jsou považovány za chyby. ErrorAndStop nebo false (výchozí).Když úkol selže, zbývající úkoly v Target element a sestavení nebudou provedeny a celou Target element a sestavení je považován za se nezdařilo. Verze rozhraní.NET Framework před 4.5 podporována pouze true a false hodnoty. Další informace naleznete v tématu Jak: Ignorovat chyby v úkolech.
Parameter	Požadované třídy úkol obsahuje jednu nebo více vlastností označena [Required] atribut. Uživatelem definovaný úkol parametr, který obsahuje hodnotu parametru jako jeho hodnotu.Může být libovolný počet parametrů v Task element s každý atribut mapování vlastnosti .NET třídy úloh.

Condition

Nepovinný atribut.Podmínka pro vyhodnocení.Další informace naleznete v tématu Nástroj MSBuild podmínky.

ContinueOnError

Nepovinný atribut.Může obsahovat jednu z následujících hodnot:

WarnAndContinue nebo true.Při úlohy nezdaří, následné úlohy v cíl element a sestavení nadále spouštět a všechny chyby z úkolu jsou považovány za upozornění.
ErrorAndContinue.Když úkol selže, následné úkoly v Target element a sestavení nadále spouštět a všechny chyby z úkolu jsou považovány za chyby.
ErrorAndStop nebo false (výchozí).Když úkol selže, zbývající úkoly v Target element a sestavení nebudou provedeny a celou Target element a sestavení je považován za se nezdařilo.

Verze rozhraní.NET Framework před 4.5 podporována pouze true a false hodnoty.

Další informace naleznete v tématu Jak: Ignorovat chyby v úkolech.

Parameter

Požadované třídy úkol obsahuje jednu nebo více vlastností označena [Required] atribut.

Uživatelem definovaný úkol parametr, který obsahuje hodnotu parametru jako jeho hodnotu.Může být libovolný počet parametrů v Task element s každý atribut mapování vlastnosti .NET třídy úloh.

Podřízené elementy

Element	Description
Výsledek	Obchody výstupy z úkolů v souboru projektu.Může být nula nebo více Output prvky v úkolu.

Nadřazené elementy

Element	Description
Cíl	Kontejner prvku pro MSBuild úkoly.

Poznámky

A Task prvek MSBuild soubor projektu vytvoří instanci úlohy, nastaví vlastnosti a spustí jej.Output Element ukládá výstupní parametry vlastnosti nebo položky v souboru projektu použít jinde.

Pokud jsou k dispozici PřiChybě prvky v nadřazené Target element úkolu jsou stále vyhodnocení úkolu selže a ContinueOnError má hodnotu false.Další informace o úlohách naleznete v Nástroj MSBuild úkoly.

Příklad

Následující příklad kódu vytvoří instance úkol Csc třída šesti vlastnostmi nastaví a spustí úlohu.Po spuštění hodnotu OutputAssembly vlastnosti objektu je umístěn do seznamu položku 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é

Koncepty

Nástroj MSBuild úkoly

Odkaz na projekt MSBuild soubor schématu

Další zdroje

Úloha MSBuild odkaz

Sdílet prostřednictvím