Partager via


Comment : spécifier la cible à générer en premier

Un fichier projet peut contenir un ou plusieurs éléments Target qui définissent la façon dont le projet est généré. Le moteur Microsoft Build Engine (MSBuild) génère le premier projet qu'il trouve et toutes les dépendances, à moins que le fichier projet contienne un attribut DefaultTargets, un attribut InitialTargets ou qu'une cible soit spécifiée dans la ligne de commande à l'aide du commutateur /target.

Utilisation de l'attribut InitialTargets

L'attribut InitialTargets de l'élément Project spécifie la première cible à exécuter, même si des cibles sont spécifiées dans la ligne de commande ou dans l'attribut DefaultTargets.

Pour spécifier une cible initiale

  • Spécifiez la cible par défaut dans l'attribut InitialTargets de l'élément Project. Par exemple :

    <Project InitialTargets="Clean">

Vous pouvez spécifier plusieurs cibles initiales dans l'attribut InitialTargets en répertoriant les différentes cibles dans l'ordre, séparées par un point-virgule. Les cibles de la liste sont exécutées séquentiellement.

Pour spécifier plusieurs cibles initiales

  • Répertoriez les cibles initiales, séparées par des points-virgules, dans l'attribut InitialTargets de l'élément Project. Par exemple, pour exécuter la cible Clean puis la cible Compile, tapez :

    <Project InitialTargets="Clean;Compile">

Utilisation de l'attribut DefaultTargets

L'attribut DefaultTargets de l'élément Project spécifie la ou les cibles générées si une cible n'est pas spécifiée explicitement dans la ligne de commande. Si les cibles sont spécifiées à la fois dans les attributs InitialTargets et DefaultTargets et qu'aucune cible n'est spécifiée sur la ligne de commande, MSBuild exécute les cibles spécifiées dans l'attribut InitialTargets puis les cibles indiquées dans l'attribut DefaultTargets.

Pour spécifier une cible par défaut

  • Spécifiez la cible par défaut dans l'attribut DefaultTargets de l'élément Project. Par exemple :

    <Project DefaultTargets="Compile">

Vous pouvez spécifier plusieurs cibles par défaut dans l'attribut DefaultTargets en classant les cibles et en les séparant à l'aide d'un point-virgule. Les cibles de la liste sont exécutées séquentiellement.

Pour spécifier plusieurs cibles par défaut

  • Répertoriez les cibles par défaut, séparées par un point-virgule, dans l'attribut DefaultTargets de l'élément Project. Par exemple, pour exécuter la cible Clean puis la cible Compile, tapez :

    <Project DefaultTargets="Clean;Compile">

Utilisation du commutateur /target

Si une cible par défaut n'est pas définie dans le fichier projet, ou si vous ne souhaitez pas utiliser cette cible par défaut, vous pouvez utiliser le commutateur de ligne de commande /target pour spécifier une autre cible. La ou les cibles spécifiées avec le commutateur /target sont exécutées au lieu des cibles spécifiées par l'attribut DefaultTargets. Les cibles spécifiées dans l'attribut InitialTargets sont toujours exécutées en premier.

Pour utiliser en premier une cible autre que la cible par défaut

  • Spécifiez la cible comme première cible à l'aide du commutateur de ligne de commande /target. Par exemple :

    msbuild file.proj /target:Clean

Pour utiliser en premier plusieurs cibles autres que les cibles par défaut

  • Répertoriez les cibles, séparées par un point-virgule ou par une virgule, à l'aide du commutateur de ligne de commande /target. Par exemple :

    msbuild <file name>.proj /t:Clean;Compile

Voir aussi

Tâches

Comment : nettoyer une génération

Concepts

Cibles de MSBuild

Autres ressources

MSBuild