Target, élément (MSBuild)

Article
08/21/2008

Mise à jour : novembre 2007

Contient un ensemble de tâches que MSBuild doit exécuter séquentiellement.

<Target Name="Target Name"
        DependsOnTargets="DependentTarget"
        Inputs="Inputs"
        Outputs="Outputs"
        Condition="'String A' == 'String B'">
    <Task>... </Task>
    <OnError... />
</Target>

Attributs et éléments

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

Attributs

Attribut	Description
Name	Attribut requis. Nom de la cible.
DependsOnTargets	Attribut facultatif. Cibles à exécuter avant que cette cible puisse s'exécuter ou que l'analyse des dépendances de niveau supérieur soit effectuée. Les différentes cibles sont séparées par des points-virgules.
Inputs	Attribut facultatif. Entrées de l'élément pour cette cible. Les éléments contenus dans cet attribut sont utilisés comme entrées dans l'analyse des dépendances de niveau supérieur.
Outputs	Attribut facultatif. Sorties attendues de cette cible. Vous pouvez appliquer des transformations aux éléments d'entrée pour générer les éléments de sortie. Pour plus d'informations sur les transformations, consultez Transformations MSBuild.
Condition	Attribut facultatif. Condition à évaluer. Si la condition a la valeur false, la cible n'exécutera pas le corps de la cible ou toute cible définie dans l'attribut DependsOnTargets. Pour plus d'informations sur les conditions, consultez Conditions MSBuild.

Éléments enfants

Élément	Description
Task	Crée et exécute une instance d'une tâche MSBuild. Une cible peut ne contenir aucune tâche ou en contenir plusieurs.
OnError	Entraîne l'exécution d'une ou plusieurs cibles si l'attribut ContinueOnError est false pour une tâche ayant échoué. Une cible peut ne contenir aucun élément OnError ou en contenir plusieurs. Ces éléments OnError, s'ils existent, doivent être les derniers éléments dans l'élément Target.

Éléments parents

Élément	Description
Project	Élément racine requis d'un fichier projet MSBuild.

Notes

La première cible à exécuter est spécifiée au moment de l'exécution. Les cibles peuvent avoir des dépendances avec d'autres cibles. Par exemple, une cible de déploiement peut dépendre d'une cible de compilation. Le moteur MSBuild exécute les dépendances en fonction de leur position dans l'attribut DependsOnTargets, de gauche à droite. Pour plus d'informations, consultez Cibles de MSBuild.

Une cible est exécutée une seule fois pendant une génération, même si plusieurs cibles dépendent d'elle.

Si une cible est ignorée parce que son attribut Condition a la valeur false, il est possible qu'elle soit néanmoins exécutée si elle est appelée ultérieurement dans la génération et que son attribut Condition a la valeur true à ce moment-là.

Exemple

L'exemple de code suivant illustre un élément Target qui exécute la tâche Csc.

<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

Cibles de MSBuild

Référence du schéma de fichier de projet MSBuild

Partager via