Éléments communs des projets MSBuildCommon MSBuild Project Items

Dans MSBuildMSBuild, un élément est une référence nommée à un ou plusieurs fichiers.In MSBuildMSBuild, an item is a named reference to one or more files. Les éléments contiennent des métadonnées, comme des noms de fichiers, des chemins et des numéros de version.Items contain metadata such as file names, paths, and version numbers. Dans Visual StudioVisual Studio, tous les types de projets ont plusieurs éléments en commun.All project types in Visual StudioVisual Studio have several items in common. Ces éléments sont définis dans le fichier Microsoft.Build.CommonTypes.xsd.These items are defined in the file Microsoft.Build.CommonTypes.xsd.

Éléments communsCommon Items

Voici une liste de tous les éléments de projet communs.The following is a list of all the common project items.

RéférenceReference

Représente une référence (managée) d'assembly dans le projet.Represents an assembly (managed) reference in the project.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
HintPathHintPath Chaîne facultative.Optional string. Chemin d’accès relatif ou absolu de l’assembly.Relative or absolute path of the assembly.
NameName Chaîne facultative.Optional string. Nom complet de l'assembly, par exemple, « System.Windows.Forms ».The display name of the assembly, for example, "System.Windows.Forms."
FusionNameFusionName Chaîne facultative.Optional string. Spécifie le nom de fusion simple ou fort de l'élément.Specifies the simple or strong fusion name for the item.

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.When this attribute is present, it can save time because the assembly file does not have to be opened to obtain the fusion name.
SpecificVersionSpecificVersion Valeur booléenne facultative.Optional boolean. Indique si seule la version figurant dans le nom de fusion doit être référencée.Specifies whether only the version in the fusion name should be referenced.
AliasAliases Chaîne facultative.Optional string. Alias éventuels de la référence.Any aliases for the reference.
PrivatePrivate Valeur booléenne facultative.Optional boolean. Indique si la référence doit être copiée dans le dossier de sortie.Specifies whether the reference should be copied to the output folder. Cet attribut correspond à la propriété Copie locale de la référence qui se trouve dans l’IDE Visual Studio.This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

COMReferenceCOMReference

Représente une référence de composant (non managé) COM dans le projet.Represents a COM (unmanaged) component reference in the project.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
NameName Chaîne facultative.Optional string. Nom complet du composant.The display name of the component.
GUIDGuid Chaîne facultative.Optional string. GUID du composant sous la forme {12345678-1234-1234-1234-1234567891234}.A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor Chaîne facultative.Optional string. Partie principale du numéro de version du composant.The major part of the version number of the component. Par exemple, « 5 » si le numéro de version complet est « 5.46 ».For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor Chaîne facultative.Optional string. Partie secondaire du numéro de version du composant.The minor part of the version number of the component. Par exemple, « 46 » si le numéro de version complet est « 5.46 ».For example, "46" if the full version number is "5.46."
dans le dossier HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID Chaîne facultative.Optional string. LocaleID du composant.The LocaleID for the component.
WrapperToolWrapperTool Chaîne facultative.Optional string. Nom de l'outil wrapper utilisé sur le composant, par exemple, « tlbimp ».The name of the wrapper tool that is used on the component, for example, "tlbimp."
IsolatedIsolated Valeur booléenne facultative.Optional boolean. Indique si le composant est un composant sans inscription.Specifies whether the component is a reg-free component.

COMFileReferenceCOMFileReference

Représente une liste de bibliothèques de types qui alimente la cible ResolvedComreference.Represents a list of type libraries that feed into the ResolvedComreference target.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
WrapperToolWrapperTool Chaîne facultative.Optional string. Nom de l'outil wrapper utilisé sur le composant, par exemple, « tlbimp ».The name of the wrapper tool that is used on the component, for example, "tlbimp."

NativeReferenceNativeReference

Représente un fichier manifeste natif ou une référence à un fichier de ce type.Represents a native manifest file or a reference to such a file.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
NameName Chaîne requise.Required string. Nom de base du fichier manifeste.The base name of the manifest file.
HintPathHintPath Chaîne requise.Required string. Chemin d’accès relatif du fichier manifeste.The relative path of the manifest file.

ProjectReferenceProjectReference

Représente une référence à un autre projet.Represents a reference to another project.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
NameName Chaîne facultative.Optional string. Nom complet de la référence.The display name of the reference.
ProjetProject Chaîne facultative.Optional string. GUID de la référence sous la forme {12345678-1234-1234-1234-1234567891234}.A GUID for the reference, in the form {12345678-1234-1234-1234-1234567891234}.
PackagePackage Chaîne facultative.Optional string. Chemin d’accès du fichier projet référencé.The path of the project file that is being referenced.

CompileCompile

Représente les fichiers sources du compilateur.Represents the source files for the compiler.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
DependentUponDependentUpon Chaîne facultative.Optional string. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.Specifies the file this file depends on to compile correctly.
AutoGenAutoGen Valeur booléenne facultative.Optional boolean. Indique si le fichier a été généré pour le projet par l’environnement de développement intégré (IDE) Visual StudioVisual Studio.Indicates whether the file was generated for the project by the Visual StudioVisual Studio integrated development environment (IDE).
LienLink Chaîne facultative.Optional string. Chemin d'accès codifiable à afficher quand le fichier se trouve physiquement en dehors de l'influence du fichier projet.The notational path to be displayed when the file is physically located outside the influence of the project file.
VisibleVisible Valeur booléenne facultative.Optional boolean. Indique si le fichier doit être affiché dans l’Explorateur de solutions de Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Chaîne facultative.Optional string. Détermine si le fichier doit être copié dans le répertoire de sortie.Determines whether to copy the file to the output directory. Les valeurs possibles sont :Values are:

1. Never1. Never
2. Toujours2. Always
3. PreserveNewest3. PreserveNewest

EmbeddedResourceEmbeddedResource

Représente les ressources à incorporer dans l'assembly généré.Represents resources to be embedded in the generated assembly.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
DependentUponDependentUpon Chaîne facultative.Optional string. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.Specifies the file this file depends on to compile correctly
GénérateurGenerator Chaîne requise.Required string. Nom du générateur de fichier exécuté sur cet élément.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Chaîne requise.Required string. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Chaîne requise.Required string. Espace de noms dans lequel le générateur de fichier s'exécutant sur cet élément doit créer du code.The namespace in which any file generator that runs on this item should create code.
LienLink Chaîne facultative.Optional string. Le chemin d'accès codifiable s'affiche si le fichier se trouve physiquement en dehors de l'influence du projet.The notational path is displayed if the file is physically located outside the influence of the project.
VisibleVisible Valeur booléenne facultative.Optional boolean. Indique si le fichier doit être affiché dans l’Explorateur de solutions de Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Chaîne facultative.Optional string. Détermine si le fichier doit être copié dans le répertoire de sortie.Determines whether to copy the file to the output directory. Les valeurs possibles sont :Values are:

1. Never1. Never
2. Toujours2. Always
3. PreserveNewest3. PreserveNewest
LogicalNameLogicalName Chaîne requise.Required string. Nom logique de la ressource incorporée.The logical name of the embedded resource.

ContenuContent

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.Represents files that are not compiled into the project, but may be embedded or published together with it.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
DependentUponDependentUpon Chaîne facultative.Optional string. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.Specifies the file this file depends on to compile correctly.
GénérateurGenerator Chaîne requise.Required string. Nom du générateur de fichier qui s'exécute sur cet élément.The name of any file generator that runs on this item.
LastGenOutputLastGenOutput Chaîne requise.Required string. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.The name of the file that was created by any file generator that was run on this item.
CustomToolNamespaceCustomToolNamespace Chaîne requise.Required string. Espace de noms dans lequel le générateur de fichier s'exécutant sur cet élément doit créer du code.The namespace in which any file generator that runs on this item should create code.
LienLink Chaîne facultative.Optional string. Chemin d’accès codifiable à afficher si le fichier se trouve physiquement en dehors de l’influence du projet.The notational path to be displayed if the file is physically located outside the influence of the project.
PublishStatePublishState Chaîne requise.Required string. État de publication du contenu, à savoir :The publish state of the content, either:

- Default- Default
- Included- Included
- Excluded- Excluded
- DataFile- DataFile
- Prerequisite- Prerequisite
IsAssemblyIsAssembly Valeur booléenne facultative.Optional boolean. Indique si le fichier est un assembly.Specifies whether the file is an assembly.
VisibleVisible Valeur booléenne facultative.Optional boolean. Indique si le fichier doit être affiché dans l’Explorateur de solutions de Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Chaîne facultative.Optional string. Détermine si le fichier doit être copié dans le répertoire de sortie.Determines whether to copy the file to the output directory. Les valeurs possibles sont :Values are:

1. Never1. Never
2. Toujours2. Always
3. PreserveNewest3. PreserveNewest

Aucun.None

Représente les fichiers qui ne doivent avoir aucun rôle dans le processus de génération.Represents files that should have no role in the build process.

Nom des métadonnées de l’élémentItem Metadata Name DescriptionDescription
DependentUponDependentUpon Chaîne facultative.Optional string. Spécifie le fichier dont dépend ce fichier pour une compilation correcte.Specifies the file this file depends on to compile correctly.
GénérateurGenerator Chaîne requise.Required string. Nom du générateur de fichier exécuté sur cet élément.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Chaîne requise.Required string. Nom du fichier créé par le générateur de fichier qui a été exécuté sur cet élément.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Chaîne requise.Required string. Espace de noms dans lequel le générateur de fichier s'exécutant sur cet élément doit créer du code.The namespace in which any file generator that runs on this item should create code.
LienLink Chaîne facultative.Optional string. Chemin d’accès codifiable à afficher si le fichier se trouve physiquement en dehors de l’influence du projet.The notational path to be displayed if the file is physically located outside the influence of the project.
VisibleVisible Valeur booléenne facultative.Optional boolean. Indique si le fichier doit être affiché dans l’Explorateur de solutions de Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Chaîne facultative.Optional string. Détermine si le fichier doit être copié dans le répertoire de sortie.Determines whether to copy the file to the output directory. Les valeurs possibles sont :Values are:

1. Never1. Never
2. Toujours2. Always
3. PreserveNewest3. PreserveNewest

BaseApplicationManifestBaseApplicationManifest

Représente le manifeste d'application de base de la build et contient les informations de sécurité de déploiement de ClickOnceClickOnce.Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

CodeAnalysisImportCodeAnalysisImport

Représente le projet FxCop à importer.Represents the FxCop project to import.

ImportImport

Représente les assemblys dont les espaces de noms doivent être importés par le compilateur Visual BasicVisual Basic.Represents assemblies whose namespaces should be imported by the Visual BasicVisual Basic compiler.

Voir aussiSee Also

Propriétés communes des projets MSBuildCommon MSBuild Project Properties