Prvek UsingTask (MSBuild)

Článek
03/04/2013

Mapuje úkol, který odkazuje úkolu prvku sestavení, která obsahuje provádění úloh.

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    TaskFactory = "ClassName"
    Condition="'String A'=='String B'" />

Atributy a elementy

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

Atributy

Atribut	Description
AssemblyName	Buď AssemblyName atributu nebo AssemblyFile je požadován atribut. Název sestavení načíst.AssemblyName Atribut přijímá silně pojmenovaných sestavení, ačkoli není nutné silné pojmenování.Tento atribut je ekvivalentní pomocí načtení sestavení Load metodu .NET Framework. Tento atribut nelze použít, pokud AssemblyFile použít atribut.
AssemblyFile	Buď AssemblyName nebo AssemblyFile je požadován atribut. Cesta k souboru sestavení.Tento atribut přijímá úplné cesty nebo relativní cesty.Relativní cesty jsou relativní vzhledem k adresáři projektu souboru nebo souboru cílů kde UsingTask prvku je deklarována.Tento atribut je ekvivalentní pomocí načtení sestavení LoadFrom metodu .NET Framework. Tento atribut nelze použít, pokud AssemblyName použít atribut.
TaskFactory	Nepovinný atribut. Určuje třídu v sestavení, který je zodpovědný za vytvoření instance zadaného Task jméno. Uživatel může také zadat TaskBody jako podřízený prvek, který factory úkol přijme a používá ke generování úkolu.Obsah TaskBody specifických úloh Factory.
TaskName	Požadovaný atribut. Název úkolu odkazovat ze sestavení.Pokud jsou možné nejasnosti, by měl tento atribut vždy určit celé obory názvů.Pokud existují nejasnosti, MSBuild zvolí libovolného shoda, která by mohla vést k neočekávaným výsledkům.
Condition	Nepovinný atribut. Podmínka pro vyhodnocení.Další informace naleznete v tématu Nástroj MSBuild podmínky.

Podřízené elementy

Element	Description
ParameterGroup	Sada parametrů, které jsou na úkolu, který je generován pomocí zadaného TaskFactory.
TaskBody	Data, která je předána TaskFactory k vytvoření instance úlohy.

Nadřazené elementy

Element	Description
Project	Požadované kořenový prvek MSBuild souboru projektu.

Poznámky

Proměnné prostředí příkazového řádku vlastnosti a vlastnosti projektu lze odkazovat kdekoli v UsingTask prvek, pokud se zobrazí v souboru projektu, výslovně nebo prostřednictvím importovaného souboru projektu.Další informace naleznete v tématu Nástroj MSBuild úkoly.

[!POZNÁMKA]

Vlastnosti projektu mít žádný význam, pokud UsingTask prvek přichází z jednoho .tasks soubory, které jsou globálně registrovány MSBuild motoru.Vlastnosti projektu nejsou globální MSBuild.

V MSBuild 4.0 pomocí úlohy lze načíst z .overridetask souborů.

Příklad

Následující příklad ukazuje použití UsingTask prvek s AssemblyName atributu.

<UsingTask TaskName="MyTask" AssemblyName="My.Assembly" TaskFactory="MyTaskFactory">
       <ParameterGroup>
              <Parameter1 ParameterType="System.String" Required="False" Output="False"/>
              <Parameter2 ParameterType="System.Int" Required="True" Output="False"/>
              ...
</ParameterGroup>
       <TaskBody>
      ... Task factory-specific data ...
       </TaskBody>
</UsingTask>

Následující příklad ukazuje použití UsingTask prvek s AssemblyFile atributu.

<UsingTask TaskName="Email"
              AssemblyFile="c:\myTasks\myTask.dll" />

Viz také

Koncepty

Nástroj MSBuild úkoly

Odkaz na projekt MSBuild soubor schématu

Další zdroje

Úloha MSBuild odkaz

Sdílet prostřednictvím