Project, élément (MSBuild)

Mise à jour : novembre 2007

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

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         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).

Xmlns

Attribut requis.

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

Éléments enfants

Élément

Description

Choisissez

Élément facultatif.

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

Import

É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.

Target

É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

Aucune.

Voir aussi

Tâches

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

Concepts

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

Vue d'ensemble de MSBuild

Référence

Référence de la ligne de commande MSBuild