UsingTask elemento (MSBuild)

Artigo
02/25/2013

Mapeia a tarefa que é referenciada em uma tarefa elemento para o assembly que contém a implementação de tarefas.

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    TaskFactory = "ClassName"
    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	Tanto o AssemblyName atributo ou o AssemblyFile o atributo é necessário. O nome do assembly para carregar.O AssemblyName atributo aceita assemblies de nome forte, embora não seja obrigatório com nomes fortes.Usar este atributo equivale a carregar um assembly usando o Load método na .NET Framework. Você não pode usar esse atributo, se a AssemblyFile atributo é usado.
AssemblyFile	Tanto o AssemblyName ou o AssemblyFile o atributo é necessário. O caminho do arquivo do assembly.Este atributo aceita caminhos completos ou caminhos relativos.Caminhos relativos são relativos ao diretório do arquivo de projeto ou arquivo de destinos onde a UsingTask elemento é declarado.Usar este atributo equivale a carregar um assembly usando o LoadFrom método na .NET Framework. Você não pode usar esse atributo, se a AssemblyName atributo é usado.
TaskFactory	Atributo opcional. Especifica a classe do assembly de que é responsável por gerar instâncias de especificado Task nome. O usuário também pode especificar um TaskBody como um elemento filho que a fábrica de tarefa recebe e usa para gerar a tarefa.O conteúdo do TaskBody são específicas para a fábrica da tarefa.
TaskName	Atributo obrigatório. O nome da tarefa para fazer referência a partir de um assembly.Se forem possíveis o 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. A condição para avaliar.Para obter mais informações, consulte Condições do MSBuild.

Elementos filho

Elemento	Descrição
ParameterGroup	O conjunto de parâmetros que aparecem na tarefa que é gerada pelo GUID TaskFactory.
TaskBody	Os dados que são passados para o TaskFactory para gerar uma instância da tarefa.

Elementos pai

Elemento	Descrição
Project	Elemento raiz necessários de um MSBuild arquivo de projeto.

Comentários

Variáveis de ambiente, propriedades de linha de comando e propriedades de nível de projeto podem ser referenciadas em qualquer lugar na UsingTask elemento se ele aparecer no arquivo de projeto ou explicitamente através 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 é proveniente de um dos arquivos .tasks globalmente registrados com o MSBuild engine.Propriedades de nível de projeto não são globais para MSBuild.

Na MSBuild 4.0, usar as tarefas pode ser carregado de arquivos .overridetask.

Exemplo

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

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

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 do arquivo de projeto MSBuild

Outros recursos

Referência de tarefa do MSBuild

Compartilhar via