UsingTask, élément (MSBuild)

Article
08/10/2011

Mappe la tâche référencée dans un élément Task à l'assembly qui contient l'implémentation de la tâche.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
AssemblyName	L'attribut AssemblyName ou AssemblyFile est obligatoire. Nom de l'assembly à charger. L'attribut AssemblyName accepte des assemblys possédant des noms forts, mais ce n'est pas indispensable. L'utilisation de cet attribut équivaut au chargement d'un assembly à l'aide de la méthode Load dans le .NET Framework. Vous ne pouvez pas l'utiliser en même temps que l'attribut AssemblyFile.
AssemblyFile	L'attribut AssemblyName ou AssemblyFile est obligatoire. Chemin d'accès du fichier de l'assembly. Cet attribut accepte les chemins d'accès complets et relatifs. Les chemins d'accès relatifs sont relatifs au répertoire du fichier projet ou du fichier de cibles, où l'élément UsingTask est déclaré. L'utilisation de cet attribut équivaut au chargement d'un assembly à l'aide de la méthode LoadFrom dans le .NET Framework. Vous ne pouvez pas l'utiliser en même temps que l'attribut AssemblyName.
TaskFactory	Attribut facultatif. Spécifie la classe dans l'assembly qui est responsable de la génération des instances du nom Task spécifié. L'utilisateur peut également spécifier un TaskBody comme un élément enfant que la fabrique de tâches reçoit et utilise pour générer la tâche. Le contenu de TaskBody est spécifique à la fabrique de tâches.
TaskName	Attribut requis. Nom de la tâche à référencer à partir d'un assembly. Si des ambiguïtés sont possibles, cet attribut doit toujours spécifier des espaces de noms complets, En cas d'ambigüités, MSBuild choisit une correspondance arbitraire, ce qui risque de produire des résultats inattendus.
Condition	Attribut facultatif. Condition à évaluer. Pour plus d'informations, consultez Conditions MSBuild.

Éléments enfants

Élément	Description
ParameterGroup	L'ensemble des paramètres qui s'affichent sur la tâche générée par la TaskFactory spécifiée.
TaskBody	Les données qui sont transmises à la TaskFactory pour générer une instance de la tâche.

Éléments parents

Élément	Description
Projet	Élément racine requis d'un fichier projet MSBuild.

Notes

Les variables d'environnement, les propriétés de ligne de commande et les propriétés de niveau projet peuvent être référencées n'importe où dans l'élément UsingTask tant qu'elles apparaissent dans le fichier projet, explicitement ou via un fichier projet importé. Pour plus d'informations, consultez Tâches MSBuild.

Remarque
Les propriétés de niveau projet n'ont aucune signification si l'élément UsingTask provient de l'un des fichiers .tasks inscrits globalement au niveau du moteur MSBuild.Les propriétés de niveau projet ne sont pas globales à MSBuild.

Dans MSBuild 4.0, l'utilisation des tâches peut être chargée à partir des fichiers .overridetask.

Exemple

L'exemple suivant montre comment utiliser l'élément UsingTask avec un attribut AssemblyName.

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

L'exemple suivant montre comment utiliser l'élément UsingTask avec un attribut AssemblyFile.

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

Voir aussi

Concepts

Tâches MSBuild

Référence du schéma de fichier de projet MSBuild

Autres ressources

Référence des tâches MSBuild

Partager via