Prvek UsingTask (MSBuild)
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 |
|---|---|
Sada parametrů, které jsou na úkolu, který je generován pomocí zadaného TaskFactory. |
|
Data, která je předána TaskFactory k vytvoření instance úlohy. |
Nadřazené elementy
Element |
Description |
|---|---|
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
Odkaz na projekt MSBuild soubor schématu