Éléments communs des projets MSBuild

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

Éléments communs

Voici une liste de tous les éléments de projet communs.

Reference

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

Nom d'élément

Description

HintPath

Chaîne facultative. Chemin d'accès relatif ou absolu de l'assembly.

Nom

Chaîne facultative. Nom complet de l'assembly, par exemple, « System.Windows.Forms ».

FusionName

Chaîne facultative. Spécifie le nom de fusion simple ou fort de l'élément.

La présence de cet attribut peut faire gagner du temps, car il vous évite d'ouvrir le fichier d'assembly pour obtenir le nom de fusion.

SpecificVersion

Valeur booléenne facultative. Indique si seule la version figurant dans le nom de fusion doit être référencée.

Alias

Chaîne facultative. Alias éventuels de la référence.

Privé

Chaîne facultative. Détermine si le fichier doit être copié dans le répertoire de sortie. Les valeurs possibles sont :

  1. Never

  2. Always

  3. PreserveNewest

COMReference

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

Nom d'élément

Description

Nom

Chaîne facultative. Nom complet du composant.

Guid

Chaîne facultative. GUID du composant sous la forme {12345678-1234-1234-1234-1234567891234}.

VersionMajor

Chaîne facultative. Partie principale du numéro de version du composant. Par exemple, « 5 » si le numéro de version complet est « 5.46 ».

VersionMinor

Chaîne facultative. 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. LocaleID du composant.

WrapperTool

Chaîne facultative. Nom de l'outil wrapper utilisé sur le composant, par exemple, « tlbimp ».

Isolated

Valeur booléenne facultative. Indique si le composant est un composant sans inscription.

COMFileReference

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

Nom d'élément

Description

WrapperTool

Chaîne facultative. 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 fichier de ce type.

Nom d'élément

Description

Nom

Chaîne requise. Nom de base du fichier manifeste.

HintPath

Chaîne requise. Chemin d'accès relatif du fichier manifeste.

ProjectReference

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

Nom d'élément

Description

Nom

Chaîne facultative. Nom complet de la référence.

Project

Chaîne facultative. GUID de la référence sous la forme {12345678-1234-1234-1234-1234567891234}.

Package

Chaîne facultative. Chemin d'accès du fichier projet référencé.

Compile

Représente les fichiers sources du compilateur.

Nom d'élément

Description

DependentUpon

Chaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.

AutoGen

Valeur booléenne facultative. 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. Chemin d'accès codifiable à afficher quand le fichier se trouve physiquement en dehors de l'influence du fichier projet.

Visible

Valeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.

CopyToOutputDirectory

Chaîne facultative. Détermine si le fichier doit être copié dans le répertoire de sortie. Les valeurs possibles sont :

  1. Never

  2. Always

  3. PreserveNewest

EmbeddedResource

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

Nom d'élément

Description

DependentUpon

Chaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.

Generator

Chaîne requise. Nom du générateur de fichier exécuté sur cet élément.

LastGenOutput

Chaîne requise. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.

CustomToolNamespace

Chaîne requise. Espace de noms dans lequel le générateur de fichier s'exécutant sur cet élément doit créer du code.

Link

Chaîne facultative. Le chemin d'accès codifiable s'affiche si le fichier se trouve physiquement en dehors de l'influence du projet.

Visible

Valeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.

CopyToOutputDirectory

Chaîne facultative. Détermine si le fichier doit être copié dans le répertoire de sortie. Les valeurs possibles sont :

  1. Never

  2. Always

  3. PreserveNewest

LogicalName

Chaîne requise. Nom logique de la ressource incorporée.

Content

Représente les fichiers qui ne sont pas compilés dans le projet, mais qui peuvent être incorporés ou publiés en même temps.

Nom d'élément

Description

DependentUpon

Chaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.

Generator

Chaîne requise. Nom du générateur de fichier qui s'exécute sur cet élément.

LastGenOutput

Chaîne requise. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.

CustomToolNamespace

Chaîne requise. Espace de noms dans lequel le générateur de fichier s'exécutant sur cet élément doit créer du code.

Link

Valeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.

PublishState

Chaîne requise. État de publication du contenu, à savoir :

  • Default

  • Included

  • Excluded

  • DataFile

  • Prerequisite

IsAssembly

Valeur booléenne facultative. Indique si le fichier est un assembly.

Visible

Valeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.

CopyToOutputDirectory

Chaîne facultative. Détermine si le fichier doit être copié dans le répertoire de sortie. Les valeurs possibles sont :

  1. Never

  2. Always

  3. PreserveNewest

None

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

Nom d'élément

Description

DependentUpon

Chaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.

Generator

Chaîne requise. Nom du générateur de fichier exécuté sur cet élément.

LastGenOutput

Chaîne requise. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.

CustomToolNamespace

Chaîne requise. Espace de noms dans lequel le générateur de fichier s'exécutant sur cet élément doit créer du code.

Link

Chaîne facultative. Chemin d'accès codifiable à afficher si le fichier se trouve physiquement en dehors de l'influence du projet.

Visible

Valeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.

CopyToOutputDirectory

Chaîne facultative. Détermine si le fichier doit être copié dans le répertoire de sortie. Les valeurs possibles sont :

  1. Never

  2. Always

  3. PreserveNewest

BaseApplicationManifest

Représente le manifeste d'application de base de la build et contient les informations de sécurité de déploiement de ClickOnce.

CodeAnalysisImport

Représente le projet FxCop à importer.

Import

Représente les 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