UsingTask, élément (MSBuild)UsingTask Element (MSBuild)

Mappe la tâche référencée dans un élément Task sur l’assembly qui contient l’implémentation de la tâche.Maps the task that is referenced in a Task element to the assembly that contains the task implementation.

<Project><Project>
<UsingTask><UsingTask>

SyntaxeSyntax

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

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
AssemblyName L'attribut AssemblyName ou AssemblyFile est requis.Either the AssemblyName attribute or the AssemblyFile attribute is required.

Nom de l'assembly à charger.The name of the assembly to load. L'attribut AssemblyName accepte les assemblys avec nom fort, bien que les noms forts ne soient pas obligatoires.The AssemblyName attribute accepts strong-named assemblies, although strong-naming is not required. L'utilisation de cet attribut équivaut au chargement d'un assembly à l'aide de la méthode Load dans .NET.Using this attribute is equivalent to loading an assembly by using the Load method in .NET.

Vous ne pouvez pas utiliser cet attribut si l'attribut AssemblyFile est utilisé.You cannot use this attribute if the AssemblyFile attribute is used.
AssemblyFile L'attribut AssemblyName ou AssemblyFile est requis.Either the AssemblyName or the AssemblyFile attribute is required.

Chemin d'accès de l'assembly.The file path of the assembly. Cet attribut accepte les chemins d'accès complets ou relatifs.This attribute accepts full paths or relative paths. Les chemins d'accès relatifs sont relatifs au répertoire du fichier projet ou du fichier .targets où l'élément UsingTask est déclaré.Relative paths are relative to the directory of the project file or targets file where the UsingTask element is declared. L'utilisation de cet attribut équivaut au chargement d'un assembly à l'aide de la méthode LoadFrom dans .NET.Using this attribute is equivalent to loading an assembly by using the LoadFrom method in .NET.

Vous ne pouvez pas utiliser cet attribut si l'attribut AssemblyName est utilisé.You cannot use this attribute if the AssemblyName attribute is used.
TaskFactory Attribut facultatif.Optional attribute.

Spécifie la classe incluse dans l'assembly qui est responsable de la génération des instances du nom Task spécifié.Specifies the class in the assembly that is responsible for generating instances of the specified Task name. L'utilisateur peut également spécifier un TaskBody en tant qu'élément enfant que la fabrique de tâches reçoit et utilise pour générer la tâche.The user may also specify a TaskBody as a child element that the task factory receives and uses to generate the task. Le contenu de TaskBody est propre à la fabrique de tâches.The contents of the TaskBody are specific to the task factory.
TaskName Attribut requis.Required attribute.

Nom de la tâche à référencer à partir d'un assembly.The name of the task to reference from an assembly. Si des ambiguïtés sont possibles, cet attribut doit toujours spécifier des espaces de noms complets.If ambiguities are possible, this attribute should always specify full namespaces. S'il existe des ambiguïtés, MSBuild choisit une correspondance arbitraire, laquelle peut produire des résultats inattendus.If there are ambiguities, MSBuild chooses an arbitrary match, which could produce unexpected results.
Condition Attribut facultatif.Optional attribute.

Condition à évaluer.The condition to evaluate. Pour plus d’informations, consultez l’article Conditions (Conditions MSBuild).For more information, see Conditions.

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
ParameterGroupParameterGroup Jeu de paramètres qui apparaissent sur la tâche générée par le TaskFactory spécifié.The set of parameters that appear on the task that is generated by the specified TaskFactory.
TaskTask Données transférées au TaskFactory pour générer une instance de la tâche.The data that is passed to the TaskFactory to generate an instance of the task.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
ProjetProject Élément racine requis d'un fichier projet MSBuildMSBuild .Required root element of an MSBuildMSBuild project file.

NotesRemarks

Les variables d'environnement, les propriétés de ligne de commande et les propriétés au niveau du projet peuvent être référencées n'importe où dans l'élément UsingTask s'il apparaît dans le fichier projet, explicitement ou via un fichier projet importé.Environment variables, command-line properties, and project-level properties can be referenced anywhere in the UsingTask element if it appears in the project file either explicitly or through an imported project file. Pour plus d’informations, consultez l’article Tâches MSBuild.For more information, see Tasks.

Note

Les propriétés au niveau du projet n'ont aucune signification si l'élément UsingTask provient de l'un des fichiers .tasks inscrits globalement auprès du moteur MSBuild.Project-level properties have no meaning if the UsingTask element is coming from one of the .tasks files that are globally registered with the MSBuild engine. Les propriétés au niveau du projet ne sont pas globales pour MSBuild.Project-level properties are not global to MSBuild.

Dans MSBuild 4.0, l’utilisation de tâches peut être chargée à partir de fichiers .overridetask.In MSBuild 4.0, using tasks can be loaded from .overridetask files.

ExempleExample

L'exemple suivant montre comment utiliser l'élément UsingTask avec un attribut AssemblyName.The following example shows how to use the UsingTask element with an AssemblyName attribute.

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

ExempleExample

L'exemple suivant montre comment utiliser l'élément UsingTask avec un attribut AssemblyFile.The following example shows how to use the UsingTask element with an AssemblyFile attribute.

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

Voir aussiSee Also

Tâches Tasks
Task Reference (Informations de référence sur les tâches MSBuild) Task Reference
Référence du schéma de fichier projetProject File Schema Reference