Elemento UsingTask (MSBuild)

Artigo
08/25/2010

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

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

Atributos e elementos

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

Atributos

Atributo	Descrição
AssemblyName	Ambos o AssemblyName ou o AssemblyFile o atributo é necessário. O nome do assembly ao carregar. The AssemblyName atributo aceita fortes conjuntos nomeados, embora não seja obrigatório. Usar este atributo equivale a carregar um assembly via o Load método na .NET Framework. Você não pode usar este atributo se o AssemblyFile o atributo é usado.
AssemblyFile	Ambos o AssemblyName ou o AssemblyFile o atributo é necessário. O caminho para o assembly. Esse atributo aceita caminhos relativos e completos. Caminhos relativos são relativos ao diretório do projeto ou arquivo de destinos onde o elemento UsingTask é declarado. Usar este atributo equivale a carregar um assembly via o LoadFrom método na .NET Framework. Você não pode usar este atributo se o AssemblyName o atributo é usado.
TaskName	Atributo obrigatório. O nome da tarefa para fazer referência a partir de um assembly. Se forem possíveis ambigüidades, este atributo sempre deve especificar espaços para nome completos. Se não houver ambigüidades, MSBuild escolhe uma correspondência arbitrária, que poderia produzir resultados inesperados.
Condition	Atributo opcional. Condição para avaliar. Para obter mais informações, consulte Condições do MSBuild.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
Project	Elemento raiz exigido de um MSBuild arquivo de projeto.

Comentários

Variáveis de ambiente, propriedades de linha de comando e em nível de projeto podem ser referenciadas em qualquer lugar dentro do UsingTask elemento, desde que ele é exibido dentro do arquivo do projeto, explicitamente ou por meio de um arquivo de projeto importado. Para obter mais informações, consulte Tarefas do MSBuild.

Observação:
Propriedades de nível de projeto não têm significado se o UsingTask elemento vem de um dos arquivos .tasks globalmente registrados com o MSBuild mecanismo. Essas propriedades não são global para MSBuild.

Exemplo

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

<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
              AssemblyName="Microsoft.Build.Tasks" />

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

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

Consulte também

Conceitos

Tarefas do MSBuild

Referência de esquema de arquivo de projeto MSBuild

Outros recursos

Referência de tarefa do MSBuild

Compartilhar via