Elemento UsingTask (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 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 |
|---|---|
O conjunto de parâmetros que aparecem na tarefa que é gerada pelo GUID 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, 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.
Dica
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
Referência do esquema de arquivos de projeto do MSBuild