UsingTask elemento (MSBuild)
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 os 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 de .NET Framework. Você não pode usar esse atributo, se a AssemblyFile atributo é usado. |
AssemblyFile |
Tanto o AssemblyName ou 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 de .NET Framework. Você não pode usar esse atributo, se a AssemblyName atributo é usado. |
TaskFactory |
Atributo opcional. Especifica a classe do assembly que é responsável por gerar instâncias especificado nome deTask . O usuário também pode especificar um TaskBody como um elemento filho que recebe a fábrica de tarefa e o usa para gerar a tarefa. O conteúdo do TaskBody são específicas para a fábrica de tarefa. |
TaskName |
Atributo obrigatório. O nome da tarefa de fazer referência a um assembly. Se a ambigüidades são possíveis, este atributo sempre deve especificar espaços para nome completos. Se houver ambigüidades, MSBuild escolhe uma correspondência arbitrária, que poderia produzir resultados inesperados. |
Condition |
Atributo opcional. A condição de avaliar. Para obter mais informações, consulte Condições do MSBuild. |
Elementos filho
Elemento |
Descrição |
|---|---|
O conjunto de parâmetros que aparecem na tarefa que é gerada pelo especificado TaskFactory. |
|
Os dados que são passados para o TaskFactory para gerar uma instância da tarefa. |
Elementos pai
Elemento |
Descrição |
|---|---|
Elemento raiz necessários de um MSBuild arquivo de projeto. |
Comentários
Variáveis de ambiente, as 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 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 é 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.
Em MSBuild 4.0, usar as tarefas pode ser carregado de arquivos de .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
Referência de esquema do arquivo de projeto MSBuild