Task, élément (MSBuild)

Article
08/21/2008

Mise à jour : novembre 2007

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="true/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. Attribut de type Boolean qui a la valeur false par défaut, s'il n'est pas spécifié. Si ContinueOnError a la valeur false et qu'une tâche échoue, le reste des tâches de l'élément Target n'est pas exécuté et tout l'élément Target est considéré comme ayant échoué. Si cet attribut est true, les tâches suivantes dans l'élément Target continuent de s'exécuter même si la tâche actuelle échoue, et toutes les erreurs provenant de la tâche sont traitées comme des avertissements.
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. Attribut de type Boolean qui a la valeur false par défaut, s'il n'est pas spécifié. Si ContinueOnError a la valeur false et qu'une tâche échoue, le reste des tâches de l'élément Target n'est pas exécuté et tout l'élément Target est considéré comme ayant échoué.

Si cet attribut est true, les tâches suivantes dans l'élément Target continuent de s'exécuter même si la tâche actuelle échoue, et toutes les erreurs provenant de la tâche sont traitées comme des avertissements.

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
Target	É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 les propriétés de celle-ci et 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>