Task, élément (MSBuild)

Article
06/09/2015

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

<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 Conditions MSBuild.
ContinueOnError	Attribut facultatif. Peut contenir une des valeurs suivantes : WarnAndContinue ou true. Lorsqu'une tâche échoue, les tâches suivantes dans l'élément de cible et la génération continue à exécuter, et toutes les erreurs de la tâche sont traitées comme avertissements. ErrorAndContinue. Lorsqu'une tâche échoue, les tâches suivantes dans l'élément d' Target et la génération continue à exécuter, et toutes les erreurs de la tâche sont traitées comme des erreurs. ErrorAndStop ou false (valeur par défaut). Lorsqu'une tâche échoue, les tâches restantes dans l'élément d' Target et la génération ne sont pas exécutées, et l'élément entier d' Target et la génération est considéré comme ayant échoué. Les versions du .NET Framework avant 4,5 pris en charge uniquement les valeurs d' true et d' false . Pour plus d’informations, consultez Comment : ignorer des erreurs dans des tâches.
Parameter	Obligatoire si la classe de la tâche contient une ou plusieurs propriétés dotées de l'attribut [Required]. Paramètre de tâche défini par l'utilisateur qui contient la valeur du paramètre comme valeur. L'élément Task peut avoir un nombre quelconque de paramètres, chaque attribut étant mappé à une propriété .NET dans la classe de la tâche.

Condition

Attribut facultatif. Condition à évaluer. Pour plus d’informations, consultez Conditions MSBuild.

ContinueOnError

Attribut facultatif. Peut contenir une des valeurs suivantes :

WarnAndContinue ou true. Lorsqu'une tâche échoue, les tâches suivantes dans l'élément de cible et la génération continue à exécuter, et toutes les erreurs de la tâche sont traitées comme avertissements.
ErrorAndContinue. Lorsqu'une tâche échoue, les tâches suivantes dans l'élément d' Target et la génération continue à exécuter, et toutes les erreurs de la tâche sont traitées comme des erreurs.
ErrorAndStop ou false (valeur par défaut). Lorsqu'une tâche échoue, les tâches restantes dans l'élément d' Target et la génération ne sont pas exécutées, et l'élément entier d' Target et la génération est considéré comme ayant échoué.

Les versions du .NET Framework avant 4,5 pris en charge uniquement les valeurs d' true et d' false .

Pour plus d’informations, consultez Comment : ignorer des erreurs dans des tâches.

Parameter

Obligatoire si la classe de la tâche contient une ou plusieurs propriétés dotées de l'attribut [Required].

Paramètre de tâche défini par l'utilisateur qui contient la valeur du paramètre comme valeur. L'élément Task peut avoir un nombre quelconque de paramètres, chaque attribut étant mappé à une propriété .NET dans la classe de la 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 d'un fichier projet MSBuild crée une instance de tâche, définit ses propriétés puis l'exécute. L'élément Output stocke des paramètres de sortie dans des propriétés ou éléments afin de les utiliser ailleurs dans le fichier projet.

S'il existe des éléments OnError dans l'élément Target parent d'une tâche, ils sont néanmoins évalués si la tâche échoue et que ContinueOnError a la valeur 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 de la tâche Csc, définit six de ses propriétés et exécute la tâche. Au terme de l'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

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