Éléments communs des projets MSBuild

Dans MSBuild, un élément est une référence nommée vers un ou plusieurs fichiers.Les éléments contiennent des métadonnées telles que des noms de fichier, des chemins d'accès et des numéros de version.Tous les types de projets dans Visual Studio possèdent plusieurs éléments en commun.Ces éléments sont définis dans le fichier microsoft.build.commontypes.xsd.

Éléments communs

Les éléments suivants forment une liste de tous les éléments de projet communs.

Référence

Représente une référence d'assembly (managé) dans le projet.

Nom d'attribut de l'élément	Description
HintPath	Chaîne facultative.Chemin absolu ou relatif de l'assembly.
Nom	Chaîne facultative.Le nom complet de l'assembly, par exemple : « System.Windows.Forms ».
FusionName	Chaîne facultative.Spécifie le nom de fusion simple ou fort pour cet élément. Lorsque cet attribut est présent, il peut faire gagner du temps car le fichier d'assembly n'a pas besoin d'être ouvert pour obtenir le nom de fusion.
SpecificVersion	Booléen facultatif.Spécifie si seule la version dans le nom de fusion doit être référencée.
Aliases	Chaîne facultative.Tout alias pour la référence.
Privé	Booléen facultatif.Spécifie si la référence doit être copiée dans le dossier de sortie.Cet attribut correspond à la propriété Locaux de copie de référence qui est dans l'IDE de Visual Studio.

COMReference

Représente une référence de composant COM (non managé) dans le projet.

Nom d'attribut de l'élément	Description
Nom	Chaîne facultative.Le nom complet du composant.
Guid	Chaîne facultative.Un GUID pour le composant, sous la forme {12345678-1234-1234-1234-1234567891234}.
VersionMajor	Chaîne facultative.La partie principale du numéro de version du composant.Par exemple, si le numéro de version complet est « 5.46 », la partie principale est « 5 ».
VersionMinor	Chaîne facultative.La partie secondaire du numéro de version du composant.Par exemple, « 46 » si le numéro de version complet est « 5.46 ».
LCID	Chaîne facultative.Le LocaleID pour le composant.
WrapperTool	Chaîne facultative.Le nom de l'outil wrapper utilisé sur le composant, par exemple, « tlbimp ».
Isolated	Booléen facultatif.Spécifie si le composant est un composant reg-free (sans inscription).

COMFileReference

Représente une liste de bibliothèques de types qui alimente la cible ResolvedComreference.

Nom d'attribut de l'élément	Description
WrapperTool	Chaîne facultative.Le nom de l'outil wrapper utilisé sur le composant, par exemple, « tlbimp ».

NativeReference

Représente un fichier manifeste natif ou une référence à un tel fichier.

Nom d'attribut de l'élément	Description
Nom	Chaîne obligatoire.Le nom de base du fichier manifeste.
HintPath	Chaîne obligatoire.Le chemin d'accès relatif au fichier manifeste.

ProjectReference

Représente une référence à un autre projet.

Nom d'attribut de l'élément	Description
Nom	Chaîne facultative.Le nom complet de la référence.
Projet	Chaîne facultative.Un GUID pour la référence, sous la forme {12345678-1234-1234-1234-1234567891234}.
Package	Chaîne facultative.Le chemin d'accès du fichier projet référencé.

Compile

Représente les fichiers sources pour le compilateur.

Nom d'attribut de l'élément	Description
DependentUpon	Booléen facultatif.Indique si le fichier dépend d'un autre fichier, afin de compiler correctement.
AutoGen	Booléen facultatif.Indique si le fichier a été généré pour le projet par l'environnement de développement intégré (IDE) de Visual Studio.
Link	Chaîne facultative.Le chemin d'accès codifié à afficher lorsque le fichier se trouve physiquement hors de l'influence du fichier projet.
Visible	Booléen facultatif.Indique s'il faut afficher le fichier dans l'Explorateur de solutions dans Visual Studio.
CopyToOutputDirectory	Booléen facultatif.Valeur par défaut = false.Spécifie s'il faut copier le fichier vers le répertoire de sortie.

EmbeddedResource

Représente les ressources à incorporer dans l'assembly généré.

Nom d'attribut de l'élément	Description
DependentUpon	Booléen facultatif.Indique si le fichier dépend d'un autre fichier, afin de compiler correctement.
Générateur	Chaîne obligatoire.Le nom de tout générateur de fichier exécuté sur cet élément.
LastGenOutput	Chaîne obligatoire.Le nom du fichier créé par tout générateur de fichier exécuté sur cet élément.
CustomToolNamespace	Chaîne obligatoire.L'espace de noms dans lequel tout générateur de fichier qui s'exécute sur cet élément doit créer le code.
Link	Chaîne facultative.Le chemin d'accès codifié est affiché si le fichier se trouve physiquement hors de l'influence du projet.
Visible	Booléen facultatif.Indique s'il faut afficher le fichier dans l'Explorateur de solutions dans Visual Studio.
CopyToOutputDirectory	Booléen facultatif.Valeur par défaut = false.Spécifie s'il faut copier le fichier vers le répertoire de sortie.
LogicalName	Chaîne obligatoire.Nom logique de la ressource incorporée.

Contenu

Représente des fichiers qui n'ont pas été compilés dans le projet, mais qui peuvent être incorporés ou publiés avec lui.

Nom d'attribut de l'élément	Description
DependentUpon	Booléen facultatif.Indique si le fichier dépend d'un autre fichier pour être incorporé ou publié correctement.
Générateur	Chaîne obligatoire.Le nom de tout générateur de fichier qui s'exécute sur cet élément.
LastGenOutput	Chaîne obligatoire.Le nom du fichier créé par tout générateur de fichier exécuté sur cet élément.
CustomToolNamespace	Chaîne obligatoire.L'espace de noms dans lequel tout générateur de fichier qui s'exécute sur cet élément doit créer le code.
Link	Booléen facultatif.Indique s'il faut afficher le fichier dans l'Explorateur de solutions dans Visual Studio.
PublishState	Chaîne obligatoire.L'état de publication du contenu : Par défaut Included Excluded DataFile Condition préalable
IsAssembly	Booléen facultatif.Spécifie si le fichier est un assembly.
Visible	Booléen facultatif.Indique s'il faut afficher le fichier dans l'Explorateur de solutions dans Visual Studio.
CopyToOutputDirectory	Booléen facultatif.Valeur par défaut = false.Spécifie s'il faut copier le fichier vers le répertoire de sortie.

Aucun

Représente des fichiers qui ne doivent avoir aucun rôle dans le processus de génération.

Nom d'attribut de l'élément	Description
DependentUpon	Booléen facultatif.Indique si le fichier dépend d'un autre fichier pour être incorporé ou publié correctement.
Générateur	Chaîne obligatoire.Le nom de tout générateur de fichier exécuté sur cet élément.
LastGenOutput	Chaîne obligatoire.Le nom du fichier créé par tout générateur de fichier exécuté sur cet élément.
CustomToolNamespace	Chaîne obligatoire.L'espace de noms dans lequel tout générateur de fichier qui s'exécute sur cet élément doit créer le code.
Link	Chaîne facultative.Le chemin d'accès codifié à afficher si le fichier se trouve physiquement hors de l'influence du projet.
Visible	Booléen facultatif.Indique s'il faut afficher le fichier dans l'Explorateur de solutions dans Visual Studio.
CopyToOutputDirectory	Booléen facultatif.Valeur par défaut = false.Spécifie s'il faut copier le fichier vers le répertoire de sortie.

BaseApplicationManifest

Représente le manifeste de l'application de base pour la génération et contient des informations de sécurité de déploiement ClickOnce.

CodeAnalysisImport

Représente le projet FxCop à importer.

Importer

Représente des assemblys dont les espaces de noms doivent être importés par le compilateur Visual Basic.

Voir aussi

Référence

Propriétés communes des projets MSBuild