Exporter (0) Imprimer
Développer tout

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'" />

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

Project

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

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.

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.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft