Élément Task de Target (MSBuild)

Article
06/19/2023

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.

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>

Partager via