Target, élément (MSBuild)

Contient un ensemble de tâches que MSBuild doit exécuter de façon séquentielle.

<Target Name="Target Name"
        Inputs="Inputs"
        Outputs="Outputs"
        Returns="Returns"
        KeepDuplicateOutputs="true/false"
        BeforeTargets="Targets"
        AfterTargets="Targets"
        DependsOnTargets="DependentTarget"
        Condition="'String A' == 'String B'">
        Label="Label">
    <Task>... </Task>
    <PropertyGroup>… </PropertyGroup>
    <ItemGroup>… </ItemGroup>
    <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.
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.
Inputs	Attribut facultatif. Les fichiers que le formulaire entre dans cette cible. Plusieurs fichiers sont séparés par des points-virgules. Les horodatages des fichiers sont comparés les horodatages des fichiers dans Outputs pour déterminer si Target est à jour. Pour plus d'informations, consultez Builds incrémentielles, Comment : effectuer des générations incrémentielles et Transformations MSBuild.
Outputs	Attribut facultatif. Les fichiers que la forme affiche dans cette cible. Plusieurs fichiers sont séparés par des points-virgules. Les horodatages des fichiers sont comparés les horodatages des fichiers dans Inputs pour déterminer si Target est à jour. Pour plus d'informations, consultez Builds incrémentielles, Comment : effectuer des générations incrémentielles et Transformations MSBuild.
Returns	Attribut facultatif. L'ensemble des éléments qui seront disponibles pour les tâches invoquant cette cible, par exemple, les tâches MSBuild. Les différentes cibles sont séparées par des points-virgules. Si les cibles dans le fichier n'ont aucun attribut d' Returns, les attributs de sorties sont utilisés à la place à cet effet.
KeepDuplicateOutputs	Attribut boléen facultatif. Si true, plusieurs références au même élément dans les retours de la cible sont stockés. Par défaut, cet attribut a la valeur false.
BeforeTargets	Attribut facultatif. Liste séparée par points-virgules de noms cibles. Une fois spécifié, indique que cette cible doit s'exécuter avant la cible ou les cibles spécifiées. Cela permet l'auteur du projet étendre un jeu existant de cibles sans les modifier directement. Pour plus d'informations, consultez Ordre de génération des cibles.
AfterTargets	Attribut facultatif. Liste séparée par points-virgules de noms cibles. Une fois spécifié, indique que cette cible doit fonctionner après la cible ou les cibles spécifiées. Cela permet l'auteur du projet étendre un jeu existant de cibles sans les modifier directement. Pour plus d'informations, consultez Ordre de génération des cibles.
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.
Label	Attribut facultatif. Un identificateur qui peut identifier ou le classement des éléments du système et d'utilisateur.

Éléments enfants

Élément	Description
Tâche	Crée et exécute une instance d'une tâche MSBuild. Une cible peut ne contenir aucune tâche ou en contenir plusieurs.
PropertyGroup	Contient un jeu d'éléments définis par l'utilisateur d' Property . À compter de.NET Framework 3.5, un élément d' Target peut contenir des éléments d' PropertyGroup .
ItemGroup	Contient un jeu d'éléments définis par l'utilisateur d' Item . À compter de.NET Framework 3.5, un élément d' Target peut contenir des éléments d' ItemGroup . Pour plus d'informations, consultez Éléments MSBuild.
OnError	Pour exécuter une ou plusieurs cibles si l'attribut d' ContinueOnError est ErrorAndStop (ou false) pour une tâche. 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. Pour plus d'informations sur l'attribut d' ContinueOnError, consultez Task, élément (MSBuild).

Éléments parents

Élément	Description
Projet	É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 des dépendances dans l'ordre dans lequel elles s'affichent 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à.

Avant MSBuild 4, Target retournait tous les éléments spécifiés dans l'attribut Outputs. Pour ce faire, MSBuild devait enregistrer ces éléments dans des tâches de cas ultérieurement dans la génération. Dans la mesure où il n'y avait aucun moyen d'indiquer quels objectifs avaient des sorties dont les appelants pouvaient avoir besoin, MSBuild accumulait tous les éléments de toutes les Outputs sur toutes les Targets invoquées. Cela a provoqué des problèmes de mise à l'échelle pour les builds qui avaient un grand nombre d'éléments de sortie.

Si l'utilisateur spécifie un Returns sur n'importe quel élément Target dans un projet, seules les Targets ayant un attribut Returns enregistrent ces éléments.

Target peut contenir à la fois un attribut Outputs et un attribut Returns. Outputs est utilisé avec Inputs pour déterminer si la cible est à jour. Le cas échéant, Returns remplace la valeur de Outputs pour déterminer les éléments retournés aux appelants. Si Returns n'est pas présent, alors Outputs seront mises à disposition des appelants, sauf dans le cas décrit précédemment.

Avant MSBuild 4, lorsqu'une Target incluait des références multiples au même élément dans ses Outputs, ces éléments en double étaient enregistrés. Dans les builds volumineuses avec un grand nombre de sorties et de nombreuses interdépendances de projet, cela entraînait le gaspillage d'une grande quantité de mémoire, car les éléments en double étaient totalement inutiles. Lorsque l'attribut d' KeepDuplicateOutputs a la valeur true, ces doublons sont stockés.

Exemple

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

<Target Name="Compile" DependsOnTargets="Resources" Returns="$(TargetPath)">
    <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