Elementi di progetto MSBuild comuniCommon MSBuild project items

In MSBuildMSBuild, un elemento è un riferimento denominato a uno o più file.In MSBuildMSBuild, an item is a named reference to one or more files. Gli elementi contengono metadati quali ad esempio nomi file, percorsi e numeri di versione.Items contain metadata such as file names, paths, and version numbers. Tutti i tipi di progetto in Visual StudioVisual Studio hanno molti elementi in comune.All project types in Visual StudioVisual Studio have several items in common. Questi elementi sono definiti nel file Microsoft.Build.CommonTypes.xsd.These items are defined in the file Microsoft.Build.CommonTypes.xsd.

Elementi comuniCommon items

Di seguito è riportato l'elenco di tutti gli elementi comuni dei progetti.The following is a list of all the common project items.

RiferimentiReference

Rappresenta un riferimento all'assembly (gestito) nel progetto.Represents an assembly (managed) reference in the project.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
HintPathHintPath Stringa facoltativa.Optional string. Percorso relativo o assoluto dell'assembly.Relative or absolute path of the assembly.
nomeName Stringa facoltativa.Optional string. Il nome visualizzato dell'assembly, ad esempio "System.Windows.Forms".The display name of the assembly, for example, "System.Windows.Forms."
FusionNameFusionName Stringa facoltativa.Optional string. Specifica il nome Fusion semplice o sicuro per l'elemento.Specifies the simple or strong fusion name for the item.

Questo attributo, se specificato, consente di risparmiare tempo in quanto non comporta l'apertura del file di assembly per ottenere il nome 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 Valore booleano facoltativo.Optional boolean. Specifica se è necessario fare riferimento solo alla versione nel nome Fusion.Specifies whether only the version in the fusion name should be referenced.
AliasAliases Stringa facoltativa.Optional string. Gli alias per il riferimento.Any aliases for the reference.
PrivatePrivate Valore booleano facoltativo.Optional boolean. Specifica se il riferimento deve essere copiato nella cartella di output.Specifies whether the reference should be copied to the output folder. Questo attributo corrisponde alla proprietà Copia localmente del riferimento nell'IDE di Visual Studio.This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

COMReferenceCOMReference

Rappresenta un riferimento a un oggetto COM (non gestito) nel progetto.Represents a COM (unmanaged) component reference in the project. Questo elemento si applica solo ai progetti .NET.This item applies only to .NET projects.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
nomeName Stringa facoltativa.Optional string. Nome visualizzato del componenteThe display name of the component.
GUIDGuid Stringa obbligatoria.Required string. GUID per il componente, nel formato {12345678-1234-1234-1234-1234567891234}.A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor Stringa obbligatoria.Required string. La parte principale del numero di versione del componente.The major part of the version number of the component. Ad esempio, "5" se il numero di versione completo è "5.46".For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor Stringa obbligatoria.Required string. La parte secondaria del numero di versione del componente.The minor part of the version number of the component. Ad esempio, "46" se il numero di versione completo è "5.46."For example, "46" if the full version number is "5.46."
LCIDLCID Stringa facoltativa.Optional string. LocaleID per il componente.The LocaleID for the component.
WrapperToolWrapperTool Stringa facoltativa.Optional string. Il nome dello strumento wrapper usato per il componente, ad esempio, "tlbimp".The name of the wrapper tool that is used on the component, for example, "tlbimp."
IsolatedIsolated Valore booleano facoltativo.Optional boolean. Specifica se il componente è un componente reg-free.Specifies whether the component is a reg-free component.

COMFileReferenceCOMFileReference

Rappresenta un elenco di librerie di tipi passate al parametro TypeLibFiles della destinazione ResolvedComreference.Represents a list of type libraries that are passed to the TypeLibFiles parameter of the ResolveComReference target. Questo elemento si applica solo ai progetti .NET.This item applies only to .NET projects.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
WrapperToolWrapperTool Stringa facoltativa.Optional string. Il nome dello strumento wrapper usato per il componente, ad esempio, "tlbimp".The name of the wrapper tool that is used on the component, for example, "tlbimp."

NativeReferenceNativeReference

Rappresenta un file manifesto nativo o un riferimento a tale file.Represents a native manifest file or a reference to such a file.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
nomeName Stringa obbligatoria.Required string. Il nome base del file manifesto.The base name of the manifest file.
HintPathHintPath Stringa obbligatoria.Required string. Il percorso relativo del file manifesto.The relative path of the manifest file.

ProjectReferenceProjectReference

Rappresenta un riferimento a un altro progetto.Represents a reference to another project.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
nomeName Stringa facoltativa.Optional string. Nome visualizzato del riferimento.The display name of the reference.
ProgettoProject Stringa facoltativa.Optional string. GUID per il riferimento, nel formato {12345678-1234-1234-1234-1234567891234}.A GUID for the reference, in the form {12345678-1234-1234-1234-1234567891234}.
PacchettoPackage Stringa facoltativa.Optional string. Il percorso del file di progetto a cui viene fatto riferimento.The path of the project file that is being referenced.
ReferenceOutputAssemblyReferenceOutputAssembly Valore booleano facoltativo.Optional boolean. Se impostato su false, non include l'output del progetto a cui si fa riferimento come riferimento del progetto, ma assicura che l'altro progetto venga compilato prima di questo.If set to false, does not include the output of the referenced project as a Reference of this project, but still ensures that the other project builds before this one. Il valore predefinito è true.Defaults to true.

CompileCompile

Rappresenta i file di origine per il compilatore.Represents the source files for the compiler.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
DependentUponDependentUpon Stringa facoltativa.Optional string. Specifica il file da cui questo file dipende per una compilazione corretta.Specifies the file this file depends on to compile correctly.
AutoGenAutoGen Valore booleano facoltativo.Optional boolean. Indica se il file è stato generato per il progetto dall'ambiente di sviluppo integrato (IDE) di Visual StudioVisual Studio.Indicates whether the file was generated for the project by the Visual StudioVisual Studio integrated development environment (IDE).
CollegamentoLink Stringa facoltativa.Optional string. Il percorso di annotazione che viene visualizzato quando il file si trova fisicamente fuori dall'influenza del file di progetto.The notational path to be displayed when the file is physically located outside the influence of the project file.
VisibileVisible Valore booleano facoltativo.Optional boolean. Indica se visualizzare il file in Esplora soluzioni in Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Stringa facoltativa.Optional string. Specifica se il file deve essere copiato nella cartella di output.Determines whether to copy the file to the output directory. I valori sono:Values are:

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

EmbeddedResourceEmbeddedResource

Rappresenta le risorse da incorporare nell'assembly generato.Represents resources to be embedded in the generated assembly.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
DependentUponDependentUpon Stringa facoltativa.Optional string. Specifica il file da cui questo file dipende per una compilazione correttaSpecifies the file this file depends on to compile correctly
GeneratorGenerator Stringa obbligatoria.Required string. Il nome di un generatore di file che viene eseguito sull'elemento.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Stringa obbligatoria.Required string. Il nome del file che è stato creato da qualsiasi generatore di file eseguito sull'elemento.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Stringa obbligatoria.Required string. Lo spazio dei nomi in cui qualsiasi generatore di file eseguito su questo elemento deve creare codice.The namespace in which any file generator that runs on this item should create code.
CollegamentoLink Stringa facoltativa.Optional string. Il percorso di annotazione che viene visualizzato se il file si trova fisicamente fuori dall'influenza del progetto.The notational path is displayed if the file is physically located outside the influence of the project.
VisibileVisible Valore booleano facoltativo.Optional boolean. Indica se visualizzare il file in Esplora soluzioni in Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Stringa facoltativa.Optional string. Specifica se il file deve essere copiato nella cartella di output.Determines whether to copy the file to the output directory. I valori sono:Values are:

1. Never1. Never
2. Always2. Always
3. PreserveNewest3. PreserveNewest
LogicalNameLogicalName Stringa obbligatoria.Required string. Nome logico della risorsa incorporata.The logical name of the embedded resource.

ContentContent

Rappresenta file che non sono compilati nel progetto, ma possono essere incorporati o pubblicati con il progetto.Represents files that are not compiled into the project, but may be embedded or published together with it.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
DependentUponDependentUpon Stringa facoltativa.Optional string. Specifica il file da cui questo file dipende per una compilazione corretta.Specifies the file this file depends on to compile correctly.
GeneratorGenerator Stringa obbligatoria.Required string. Il nome di un generatore di file che viene eseguito sull'elemento.The name of any file generator that runs on this item.
LastGenOutputLastGenOutput Stringa obbligatoria.Required string. Il nome del file creato da qualsiasi generatore di file che è stato eseguito sull'elemento.The name of the file that was created by any file generator that was run on this item.
CustomToolNamespaceCustomToolNamespace Stringa obbligatoria.Required string. Lo spazio dei nomi in cui qualsiasi generatore di file eseguito su questo elemento deve creare codice.The namespace in which any file generator that runs on this item should create code.
CollegamentoLink Stringa facoltativa.Optional string. Il percorso di annotazione che viene visualizzato quando il file si trova fisicamente fuori dall'influenza del progetto.The notational path to be displayed if the file is physically located outside the influence of the project.
PublishStatePublishState Stringa obbligatoria.Required string. Lo stato di pubblicazione del contenuto, che può essere:The publish state of the content, either:

- Impostazione predefinita- Default
- Incluso- Included
- Escluso- Excluded
- DataFile- DataFile
- Prerequisito- Prerequisite
IsAssemblyIsAssembly Valore booleano facoltativo.Optional boolean. Specifica se il file è un assembly.Specifies whether the file is an assembly.
VisibileVisible Valore booleano facoltativo.Optional boolean. Indica se visualizzare il file in Esplora soluzioni in Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Stringa facoltativa.Optional string. Specifica se il file deve essere copiato nella cartella di output.Determines whether to copy the file to the output directory. I valori sono:Values are:

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

nessunoNone

Rappresenta i file che non hanno un ruolo nel processo di compilazione.Represents files that should have no role in the build process.

Nome metadati degli elementiItem metadata name DESCRIZIONEDescription
DependentUponDependentUpon Stringa facoltativa.Optional string. Specifica il file da cui questo file dipende per una compilazione corretta.Specifies the file this file depends on to compile correctly.
GeneratorGenerator Stringa obbligatoria.Required string. Il nome di un generatore di file che viene eseguito sull'elemento.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Stringa obbligatoria.Required string. Il nome del file che è stato creato da qualsiasi generatore di file eseguito sull'elemento.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Stringa obbligatoria.Required string. Lo spazio dei nomi in cui qualsiasi generatore di file eseguito su questo elemento deve creare codice.The namespace in which any file generator that runs on this item should create code.
CollegamentoLink Stringa facoltativa.Optional string. Il percorso di annotazione che viene visualizzato quando il file si trova fisicamente fuori dall'influenza del progetto.The notational path to be displayed if the file is physically located outside the influence of the project.
VisibileVisible Valore booleano facoltativo.Optional boolean. Indica se visualizzare il file in Esplora soluzioni in Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Stringa facoltativa.Optional string. Specifica se il file deve essere copiato nella cartella di output.Determines whether to copy the file to the output directory. I valori sono:Values are:

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

BaseApplicationManifestBaseApplicationManifest

Rappresenta il manifesto dell'applicazione di base per la compilazione e contiene informazioni sulla protezione di distribuzione ClickOnceClickOnce.Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

CodeAnalysisImportCodeAnalysisImport

Rappresenta il progetto FxCop da importare.Represents the FxCop project to import.

ImportImport

Rappresenta gli assembly i cui spazi dei nomi devono essere importati dal compilatore Visual BasicVisual Basic.Represents assemblies whose namespaces should be imported by the Visual BasicVisual Basic compiler.

Vedere ancheSee also