Compartilhar via

Elemento UsingTask (MSBuild)

Mapeia a tarefa referenciada em um elemento Task para o assembly que contém a implementação da tarefa.

<Project><UsingTask>

Sintaxe

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

Observação

Ao contrário de propriedades e itens, o primeiroUsingTask elemento que se aplica a um TaskName é usado; para substituir tarefas, você deve definir um novo UsingTaskantes do existente ou especificar Override="true" no novo UsingTask.

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Attribute Description
Architecture Atributo opcional.

Especifica que a tarefa deve ser executada em um processo de bits especificado. Se o processo atual não atender ao requisito, a tarefa será executada em um processo de host de tarefa que atende.

Os valores com suporte são x86 (32 bits), x64 (64 bits) CurrentArchitecturee * (qualquer arquitetura).
AssemblyName AssemblyName O atributo ou o AssemblyFile atributo é necessário.

O nome do assembly a ser carregado. O AssemblyName atributo aceita assemblies de nome forte, embora a nomenclatura forte não seja necessária. Usar esse atributo é equivalente a carregar um assembly usando o Load método no .NET.

Você não poderá usar esse atributo se o AssemblyFile atributo for usado.
AssemblyFile O atributo ou o AssemblyNameAssemblyFile atributo é necessário.

O caminho do arquivo do assembly. Esse atributo aceita caminhos completos ou caminhos relativos. Caminhos relativos são relativos ao diretório do arquivo de projeto ou arquivo de destino em que o UsingTask elemento é declarado. Usar esse atributo é equivalente a carregar um assembly usando o LoadFrom método no .NET.

Você não poderá usar esse atributo se o AssemblyName atributo for usado.
Override Atributo opcional.

Especifica que esse UsingTask elemento deve ser uma prioridade maior do que outros elementos que definem o mesmo nome da tarefa. Apenas uma substituição é permitida por nome de tarefa. Adicionado no MSBuild 17.2.
Runtime Atributo opcional.

Especifica que a tarefa deve ser executada em um runtime do .NET Framework da versão especificada. Se o processo atual não atender ao requisito, a tarefa será executada em um processo de host de tarefa que atende.

Os valores com suporte são 'NET' (.NET Core e .NET 5 ou superior), CLR2 (.NET Framework 3.5), CLR4 (.NET Framework 4.7.2 ou superior), CurrentRuntimeNET (começando no .NET 10 ou superior) e * (qualquer runtime). Você só pode chamar NET tarefas de Runtime quando estiver executando o MSBuild do .NET Framework quando estiver usando o MSBuild 18.0 (Visual Studio 2026 ou posterior) ou o SDK do .NET 10 ou superior, e não é possível chamar tarefas CLR2/CLR4 do MSBuild do .NET (ao executar dotnet build).
TaskFactory Atributo opcional.

Especifica a classe no assembly responsável por gerar instâncias do nome especificado Task . O usuário também pode especificar um Task elemento filho que a fábrica de tarefas recebe e usa para gerar a tarefa. O conteúdo do Task é específico para a fábrica de tarefas. O padrão TaskFactory é AssemblyTaskFactory, que carrega a tarefa no processo em execução.
TaskName Atributo necessário.

O nome da tarefa a ser referenciada de um assembly. Se as ambiguidades forem possíveis, esse atributo sempre deverá especificar namespaces completos. Se houver ambiguidades, o MSBuild escolherá uma correspondência arbitrária, o que pode produzir resultados inesperados.
Condition Atributo opcional.

A condição a ser avaliada. Para obter mais informações, consulte Condições.

Elementos filho

Elemento Description
Parametergroup O conjunto de parâmetros que aparecem na tarefa gerada pelo especificado TaskFactory.
Tarefa Os dados que são passados para gerar TaskFactory uma instância da tarefa.

Elementos pai

Elemento Description
Projeto Elemento raiz necessário de um arquivo de projeto do MSBuild.

Observações

Variáveis de ambiente, propriedades de linha de comando, propriedades no nível do projeto e itens no nível do projeto podem ser referenciados nos UsingTask elementos incluídos no arquivo de projeto diretamente ou por meio de um arquivo de projeto importado. Para obter mais informações, consulte Tarefas.

Observação

Propriedades e itens no nível do projeto não terão significado se o UsingTask elemento for proveniente de um dos arquivos .tasks que estão registrados globalmente com o mecanismo MSBuild. Os valores no nível do projeto não são globais para o MSBuild.

No MSBuild 4.0, o uso de tarefas pode ser carregado de .overridetask arquivos.

O assembly que contém a tarefa personalizada é carregado quando o Task primeiro é usado.

Exemplo 1

O exemplo a seguir mostra como usar o UsingTask elemento com um AssemblyFile atributo.

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

Como não há nenhum Runtime ou TaskHost especificado, a tarefa é executada no processo do MSBuild, no runtime e na arquitetura que estão em execução para um determinado build.

Exemplo 2

O exemplo a seguir mostra como usar o UsingTask elemento com um AssemblyName atributo e um personalizado TaskFactory definido nesse assembly.

<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>

Consulte também

  • Last updated on