Elemento UsingTask (MSBuild)
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 |
|---|---|
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.
.gif "Observação") 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
Referência de esquema de arquivo de projeto MSBuild