Partager via


Élément Task de Target (MSBuild)

Crée et exécute une instance d’une tâche MSBuild. Le nom de l’élément est déterminé par le nom de la tâche en cours de création.

<Project><Target>

Syntaxe

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Attributs et éléments

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

Attributs

Attribut Description
Condition Attribut facultatif. Condition à évaluer. Pour plus d’informations, consultez l’article Conditions (Conditions MSBuild).
ContinueOnError Attribut facultatif. Peut contenir l’une des valeurs suivantes :

- WarnAndContinue ou true. En cas d’échec d’une tâche, l’exécution des tâches suivantes de l’élément Target et de la génération se poursuit, et toutes les erreurs de la tâche sont considérées comme des avertissements.
- ErrorAndContinue. En cas d’échec d’une tâche, l’exécution des tâches suivantes de l’élément Target et de la génération se poursuit, et toutes les erreurs de la tâche sont considérées comme des erreurs.
- ErrorAndStop ou false (par défaut). En cas d’échec d’une tâche, les tâches restantes de l’élément Target et de la génération ne sont pas exécutées, et tout l’élément Target ainsi que la génération sont considérés comme étant en échec.

Les versions de .NET Framework antérieures à 4.5 prenaient en charge uniquement les valeurs true et false.

Pour plus d’informations, voir Guide pratique : Ignorer les erreurs dans les tâches.
Parameter Il est nécessaire si la classe de tâche contient une ou plusieurs propriétés dotées de l’attribut [Required].

Un paramètre de tâche défini par l’utilisateur qui contient la valeur du paramètre comme sa propre valeur. Le nombre de paramètres dans l’élément Task peut varier, avec chaque attribut correspondant à une propriété .NET dans la classe de tâche.

Éléments enfants

Élément Description
Sortie Stocke des sorties de la tâche dans le fichier projet. Une tâche peut ne contenir aucun élément Output ou en contenir plusieurs.

Éléments parents

Élément Description
Cible Élément conteneur pour les tâches MSBuild.

Notes

Un élément Task dans un fichier projet MSBuild crée une instance d’une tâche, définit des propriétés sur celle-ci et l’exécute. L’élément Output stocke les paramètres de sortie dans les propriétés ou les éléments à utiliser ailleurs dans le fichier projet.

S’il existe des éléments OnError dans l’élément Target parent d’une tâche, ils seront néanmoins évalués si la tâche échoue, et ContinueOnError a la valeur de false. Pour plus d’informations sur les tâches, consultez Tâches MSBuild.

Exemple

L’exemple de code suivant crée une instance de la classe CSC, tâche, définit six des propriétés et exécute la tâche. Après exécution, la valeur de la propriété OutputAssembly de l’objet est placée dans une liste d’éléments nommée FinalAssemblyName.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

Voir aussi