UsingTask, élément (MSBuild)
Mise à jour : novembre 2007
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"
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 via 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 à l'assembly. Cet attribut accepte les chemins d'accès complets et relatifs. Les chemins d'accès relatif sont relatifs au répertoire du projet ou des fichiers cibles où l'élément UsingTask est déclaré. L'utilisation de cet attribut équivaut au chargement d'un assembly via la méthode LoadFrom dans le .NET Framework. Vous ne pouvez pas l'utiliser en même temps que l'attribut AssemblyName. |
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
Aucun.
Éléments parents
Élément |
Description |
|---|---|
Élément racine requis d'un fichier projet MSBuild. |
Notes
Les variables d'environnement, les propriétés de ligne de commande et 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.
.gif "Remarque") 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. Ces propriétés ne sont pas globales à MSBuild. |
Exemple
L'exemple suivant montre comment utiliser l'élément UsingTask avec un attribut AssemblyName.
<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
AssemblyName="Microsoft.Build.Tasks" />
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
Référence du schéma de fichier de projet MSBuild