Common MSBuild Project Items

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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.

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émentDescription
HintPathChaîne facultative. Chemin d'accès relatif ou absolu de l'assembly.
NomChaîne facultative. Nom complet de l'assembly, par exemple, « System.Windows.Forms ».
FusionNameChaî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.
SpecificVersionValeur booléenne facultative. Indique si seule la version figurant dans le nom de fusion doit être référencée.
AliasChaîne facultative. Alias éventuels de la référence.
PrivéValeur booléenne facultative. Indique si la référence doit être copiée dans le dossier de sortie. Cet attribut correspond à la propriété Copie locale de la référence qui se trouve dans l'IDE de Visual Studio.

COMReference

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

Nom d'élémentDescription
NomChaîne facultative. Nom complet du composant.
GuidChaîne facultative. GUID du composant sous la forme {12345678-1234-1234-1234-1234567891234}.
VersionMajorChaîne facultative. Partie principale du numéro de version du composant. Par exemple, « 5 » si le numéro de version complet est « 5.46 ».
VersionMinorChaîne facultative. Partie secondaire du numéro de version du composant. Par exemple, « 46 » si le numéro de version complet est « 5.46 ».
LCIDChaîne facultative. LocaleID du composant.
WrapperToolChaîne facultative. Nom de l'outil wrapper utilisé sur le composant, par exemple, « tlbimp ».
IsolatedValeur 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émentDescription
WrapperToolChaî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émentDescription
NomChaîne requise. Nom de base du fichier manifeste.
HintPathChaîne requise. Chemin d'accès relatif du fichier manifeste.

ProjectReference

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

Nom d'élémentDescription
NomChaîne facultative. Nom complet de la référence.
ProjectChaîne facultative. GUID de la référence sous la forme {12345678-1234-1234-1234-1234567891234}.
PackageChaîne facultative. Chemin d'accès du fichier projet référencé.

Compile

Représente les fichiers sources du compilateur.

Nom d'élémentDescription
DependentUponChaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.
AutoGenValeur 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.
LinkChaîne facultative. Chemin d'accès codifiable à afficher quand le fichier se trouve physiquement en dehors de l'influence du fichier projet.
VisibleValeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.
CopyToOutputDirectoryChaî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émentDescription
DependentUponChaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.
GeneratorChaîne requise. Nom du générateur de fichier exécuté sur cet élément.
LastGenOutputChaîne requise. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.
CustomToolNamespaceChaî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.
LinkChaîne facultative. Le chemin d'accès codifiable s'affiche si le fichier se trouve physiquement en dehors de l'influence du projet.
VisibleValeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.
CopyToOutputDirectoryChaî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
LogicalNameChaî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émentDescription
DependentUponChaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.
GeneratorChaîne requise. Nom du générateur de fichier qui s'exécute sur cet élément.
LastGenOutputChaîne requise. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.
CustomToolNamespaceChaî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.
LinkValeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.
PublishStateChaîne requise. État de publication du contenu, à savoir :

- Default
- Included
- Excluded
- DataFile
- Prerequisite
IsAssemblyValeur booléenne facultative. Indique si le fichier est un assembly.
VisibleValeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.
CopyToOutputDirectoryChaî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émentDescription
DependentUponChaîne facultative. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.
GeneratorChaîne requise. Nom du générateur de fichier exécuté sur cet élément.
LastGenOutputChaîne requise. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.
CustomToolNamespaceChaî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.
LinkChaîne facultative. Chemin d'accès codifiable à afficher si le fichier se trouve physiquement en dehors de l'influence du projet.
VisibleValeur booléenne facultative. Indique si le fichier doit être affiché dans l'Explorateur de solutions de Visual Studio.
CopyToOutputDirectoryChaî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.

Common MSBuild Project Properties

Afficher: