Partager via

Project, élément (MSBuild)

  • Article

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

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         TreatAsLocalProperty="PropertyA;PropertyB"
         ToolsVersion=<version number>
         xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Choose>... </Choose>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Target>... </Target>
    <UsingTask.../>
    <ProjectExtensions>... </ProjectExtensions>
    <Import... />
</Project>

Attributs et éléments

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

Attributs

Attribut

Description

DefaultTargets

Attribut facultatif.

Cible(s) par défaut représentant le point d'entrée de la génération si aucune cible n'a été spécifiée.Lorsqu'il existe plusieurs cibles, elles doivent être séparées par des points-virgules (;).

Si aucune cible par défaut n'est spécifiée dans l'attribut DefaultTargets ou dans la ligne de commande MSBuild, le moteur exécute la première cible figurant dans le fichier projet après évaluation des éléments Import.

InitialTargets

Attribut facultatif.

Cible(s) initiale(s) à exécuter avant les cibles spécifiées dans l'attribut DefaultTargets ou sur la ligne de commande.Lorsqu'il existe plusieurs cibles, elles doivent être séparées par des points-virgules (;).

ToolsVersion

Attribut facultatif.

La version de l'ensemble d'outils que MSBuild utilise pour déterminer les valeurs de $(MSBuildBinPath) et $(MSBuildToolsPath).

TreatAsLocalProperty

Attribut facultatif.

Noms de propriétés qui ne sont pas considérés comme globaux.Cet attribut empêché les propriétés spécifiques de ligne de commande pour remplacer les valeurs de propriété définies dans un fichier de projet ou de cibles et tous les importations ultérieures.Plusieurs propriétés sont point-virgule (;) délimité.

Normalement, les propriétés globales substituent les valeurs de propriété définies dans le fichier de projet ou de cibles.Si la propriété est répertorié dans la valeur d' TreatAsLocalProperty , la valeur de propriété globale ne remplace pas les valeurs de propriété définies dans ce fichier et toutes les importations ultérieures.Pour plus d’informations, consultez Comment : générer les mêmes fichiers sources avec des options différentes.

RemarqueRemarque
Vous définissez les propriétés globales à une invite de commandes à l'aide de le commutateur d' /property (ou /p).Vous pouvez également définir ou modifier les propriétés globales pour les projets enfants dans une build à projets multiples à l'aide de l'attribut d' Properties de la tâche MSBuild.Pour plus d’informations, consultez MSBuild, tâche.

Xmlns

Attribut requis.

L'attribut xmlns doit avoir la valeur de "https://schemas.microsoft.com/developer/msbuild/2003".

Éléments enfants

Élément

Description

Choose

Élément facultatif.

Évalue des éléments enfants pour sélectionner un jeu d'éléments ItemGroup et/ou d'éléments PropertyGroup à évaluer.

Importer

Élément facultatif.

Permet à un fichier projet d'importer un autre fichier projet.Un projet peut ne contenir aucun élément Import ou en contenir plusieurs.

ItemGroup

Élément facultatif.

Élément regroupant des éléments individuels.Les éléments sont spécifiés à l'aide de l'élément Item.Un projet peut ne contenir aucun élément ItemGroup ou en contenir plusieurs.

ProjectExtensions

Élément facultatif.

Permet de faire persister des informations autres que MSBuild dans un fichier projet MSBuild.Un projet peut contenir un seul élément ProjectExtensions ou n'en contenir aucun.

PropertyGroup

Élément facultatif.

Élément regroupant des propriétés individuelles.Les propriétés sont spécifiées à l'aide de l'élément Property.Un projet peut ne contenir aucun élément PropertyGroup ou en contenir plusieurs.

Cible

Élément facultatif.

Contient un ensemble de tâches que MSBuild doit exécuter séquentiellement.Les tâches sont spécifiées à l'aide de l'élément Task.Un projet peut ne contenir aucun élément Target ou en contenir plusieurs.

UsingTask

Élément facultatif.

Permet d'inscrire des tâches dans MSBuild.Un projet peut ne contenir aucun élément UsingTask ou en contenir plusieurs.

Éléments parents

Aucun

Voir aussi

Tâches

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

Référence

Référence de la ligne de commande MSBuild

Concepts

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

Autres ressources

MSBuild