UsingTask – element (MSBuild)UsingTask element (MSBuild)

Mapuje úlohu, na kterou je odkazováno v elementu Task , na sestavení, které obsahuje implementaci úlohy.Maps the task that is referenced in a Task element to the assembly that contains the task implementation.

<Project> <UsingTask><Project> <UsingTask>

SyntaxSyntax

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

Poznámka

Na rozdíl od vlastností a položek first UsingTask bude použit první prvek, který se vztahuje na a, TaskName aby bylo možné přepsat úkoly, které je nutné definovat UsingTask před existujícím.Unlike properties and items, the first UsingTask element that applies to a TaskName will be used; to override tasks you must define a new UsingTask before the existing one.

Atributy a elementyAttributes and elements

Následující části popisují atributy, podřízené prvky a nadřazené prvky.The following sections describe attributes, child elements, and parent elements.

AtributyAttributes

AtributAttribute PopisDescription
Architecture Nepovinný atribut.Optional attribute.

Určuje, že úloha musí běžet v procesu zadaného bitová verze.Specifies that the task must run in a process of the specified bitness. Pokud aktuální proces nesplňuje požadavky, úloha se spustí v procesu hostitele úlohy, který provede.If the current process does not satisfy the requirement, the task will be run in a task host process that does.

Podporované hodnoty jsou x86 (32 – bit), x64 (64-bit), CurrentArchitecture a * (jakákoli architektura).Supported values are x86 (32-bit), x64 (64-bit), CurrentArchitecture, and * (any architecture).
AssemblyName AssemblyNameJe vyžadován buď atribut, nebo AssemblyFile atribut.Either the AssemblyName attribute or the AssemblyFile attribute is required.

Název sestavení, které chcete načíst.The name of the assembly to load. AssemblyNameAtribut přijímá sestavení se silným názvem, i když silné pojmenovávání není vyžadováno.The AssemblyName attribute accepts strong-named assemblies, although strong-naming is not required. Použití tohoto atributu je ekvivalentní k načtení sestavení pomocí Load metody v rozhraní .NET.Using this attribute is equivalent to loading an assembly by using the Load method in .NET.

Tento atribut nelze použít, je-li AssemblyFile použit atribut.You cannot use this attribute if the AssemblyFile attribute is used.
AssemblyFile AssemblyName AssemblyFile Je vyžadován buď atribut, nebo.Either the AssemblyName or the AssemblyFile attribute is required.

Cesta k souboru sestavení.The file path of the assembly. Tento atribut přijímá úplné cesty nebo relativní cesty.This attribute accepts full paths or relative paths. Relativní cesty jsou relativní vzhledem k adresáři souboru projektu nebo souboru cílů, kde UsingTask je element deklarovaný.Relative paths are relative to the directory of the project file or targets file where the UsingTask element is declared. Použití tohoto atributu je ekvivalentní k načtení sestavení pomocí LoadFrom metody v rozhraní .NET.Using this attribute is equivalent to loading an assembly by using the LoadFrom method in .NET.

Tento atribut nelze použít, je-li AssemblyName použit atribut.You cannot use this attribute if the AssemblyName attribute is used.
Runtime Nepovinný atribut.Optional attribute.

Určuje, že úloha musí běžet v modulu .NET Framework runtime zadané verze.Specifies that the task must run in a .NET Framework runtime of the specified version. Pokud aktuální proces nesplňuje požadavky, úloha se spustí v procesu hostitele úlohy, který provede.If the current process does not satisfy the requirement, the task will be run in a task host process that does. Nepodporuje se v nástroji MSBuild pro .NET Core.Not supported in .NET Core MSBuild.

Podporované hodnoty jsou CLR2 (.NET Framework 3,5), CLR4 (.NET Framework 4.7.2 nebo vyšší), CurrentRuntime a * (libovolný modul runtime).Supported values are CLR2 (.NET Framework 3.5), CLR4 (.NET Framework 4.7.2 or higher), CurrentRuntime, and * (any runtime).
TaskFactory Nepovinný atribut.Optional attribute.

Určuje třídu v sestavení, která je zodpovědná za generování instancí zadaného Task názvu.Specifies the class in the assembly that is responsible for generating instances of the specified Task name. Uživatel může také určit Task jako podřízený prvek, který objekt pro vytváření úloh obdrží a použije k vygenerování úlohy.The user may also specify a Task as a child element that the task factory receives and uses to generate the task. Obsah je Task specifický pro objekt pro vytváření úloh.The contents of the Task are specific to the task factory.
TaskName Požadovaný atribut.Required attribute.

Název úkolu, který se má odkazovat ze sestavení.The name of the task to reference from an assembly. Pokud je to možné, měl by tento atribut vždy určovat celé obory názvů.If ambiguities are possible, this attribute should always specify full namespaces. Pokud existují dvojznačnosti, nástroj MSBuild zvolí libovolnou shodu, což by mohlo způsobit neočekávané výsledky.If there are ambiguities, MSBuild chooses an arbitrary match, which could produce unexpected results.
Condition Nepovinný atribut.Optional attribute.

Podmínka, která má být vyhodnocena.The condition to evaluate. Další informace najdete v tématu podmínky.For more information, see Conditions.

Podřízené prvkyChild elements

ElementElement PopisDescription
ParameterGroup –ParameterGroup Sada parametrů, která se zobrazí na úkolu vygenerovaného zadaným TaskFactory .The set of parameters that appear on the task that is generated by the specified TaskFactory.
ÚlohaTask Data předaná do TaskFactory pro vygenerování instance úkolu.The data that is passed to the TaskFactory to generate an instance of the task.

Nadřazené prvkyParent elements

ElementElement PopisDescription
ProjektProject Požadovaný kořenový element souboru projektu MSBuild.Required root element of an MSBuild project file.

PoznámkyRemarks

Proměnné prostředí, vlastnosti příkazového řádku, vlastnosti na úrovni projektu a položky na úrovni projektu lze odkazovat v UsingTask prvcích obsažených v souboru projektu buď přímo, nebo prostřednictvím importovaného souboru projektu.Environment variables, command-line properties, project-level properties, and project-level items can be referenced in the UsingTask elements included in the project file either directly or through an imported project file. Další informace najdete v tématu úlohy.For more information, see Tasks.

Poznámka

Vlastnosti a položky na úrovni projektu nemají žádný význam, pokud UsingTask prvek přichází z jednoho ze souborů . Tasks , které jsou globálně registrovány v modulu MSBuild.Project-level properties and items have no meaning if the UsingTask element is coming from one of the .tasks files that are globally registered with the MSBuild engine. Hodnoty na úrovni projektu nejsou globálním pro MSBuild.Project-level values are not global to MSBuild.

V MSBuild 4,0 lze pomocí úloh načíst ze souborů . overridetask .In MSBuild 4.0, using tasks can be loaded from .overridetask files.

Sestavení obsahující vlastní úlohu je načteno při Task prvním použití.The assembly containing the custom task is loaded when the Task is first used.

Příklad 1Example 1

Následující příklad ukazuje, jak použít UsingTask element s AssemblyName atributem.The following example shows how to use the UsingTask element with an AssemblyName attribute.

<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>
       <Task>
      ... Task factory-specific data ...
       </Task>
</UsingTask>

Příklad 2Example 2

Následující příklad ukazuje, jak použít UsingTask element s AssemblyFile atributem.The following example shows how to use the UsingTask element with an AssemblyFile attribute.

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

Viz takéSee also