Impostazione degli attributi dell'assemblySetting Assembly Attributes

Gli attributi dell'assembly sono valori che forniscono informazioni relative a un assembly.Assembly attributes are values that provide information about an assembly. Tali attributi sono suddivisi nei seguenti gruppi di informazioni:The attributes are divided into the following sets of information:

  • Attributi relativi all'identità dell'assembly.Assembly identity attributes.

  • Attributi informativi.Informational attributes.

  • Attributi relativi al manifesto dell'assembly.Assembly manifest attributes.

  • Attributi relativi al nome sicuro.Strong name attributes.

Attributi relativi all'identità dell'assemblyAssembly Identity Attributes

Tre attributi, insieme a un nome sicuro (se disponibile), consentono di determinare l'identità di un assembly: il nome, la versione e le impostazioni cultura.Three attributes, together with a strong name (if applicable), determine the identity of an assembly: name, version, and culture. Il nome completo dell'assembly è costituito da questi attributi, che risultano necessari per creare riferimenti all'assembly nel codice.These attributes form the full name of the assembly and are required when referencing the assembly in code. È possibile usare gli attributi per impostare la versione e le impostazioni cultura di un assembly.You can use attributes to set an assembly's version and culture. Il valore relativo al nome viene impostato dal compilatore o da Assembly Linker (Al.exe) quando l'assembly viene creato ed è basato sul file contenente il manifesto dell'assembly.The compiler or the Assembly Linker (Al.exe) sets the name value when the assembly is created, based on the file containing the assembly manifest.

Nella tabella seguente vengono descritti gli attributi relativi alla versione e alle impostazioni cultura.The following table describes the version and culture attributes.

Attributi relativi all'identità dell'assemblyAssembly identity attribute DescrizioneDescription
AssemblyCultureAttribute Campo elenco in cui vengono indicate le impostazioni cultura supportate dall'assembly.Enumerated field indicating the culture that the assembly supports. È possibile specificare anche l'indipendenza dalle impostazioni cultura per l'assembly, indicando che nell'assembly sono presenti le risorse per le impostazioni cultura predefinite.An assembly can also specify culture independence, indicating that it contains the resources for the default culture. Nota: tutti gli assembly il cui attributo "Culture" non è impostato su Null vengono considerati dal runtime come assembly satellite.Note: The runtime treats any assembly that does not have the culture attribute set to null as a satellite assembly. e sono soggetti alle regole di associazione degli assembly satellite.Such assemblies are subject to satellite assembly binding rules. Per altre informazioni, vedere Modalità di individuazione di assembly del runtime.For more information, see How the Runtime Locates Assemblies.
AssemblyFlagsAttribute Valore che consente di impostare gli attributi relativi all'assembly, indicando ad esempio se è consentita l'esecuzione affiancata di più versioni.Value that sets assembly attributes, such as whether the assembly can be run side by side.
AssemblyVersionAttribute Valore numerico in formato principale.secondario.build.revisione (ad esempio, 2.4.0.0).Numeric value in the format major.minor.build.revision (for example, 2.4.0.0). Questo valore viene usato da Common Language Runtime per eseguire operazioni di associazione in assembly con nome sicuro.The common language runtime uses this value to perform binding operations in strong-named assemblies. Nota: se l'attributo AssemblyInformationalVersionAttribute non viene applicato a un assembly, il numero di versione specificato dall'attributo AssemblyVersionAttribute viene usato dalle proprietà Application.ProductVersion, Application.UserAppDataPath e Application.UserAppDataRegistry.Note: If the AssemblyInformationalVersionAttribute attribute is not applied to an assembly, the version number specified by the AssemblyVersionAttribute attribute is used by the Application.ProductVersion, Application.UserAppDataPath, and Application.UserAppDataRegistry properties.

Nel seguente esempio di codice viene mostrato come applicare a un assembly gli attributi relativi alla versione e alle impostazioni cultura.The following code example shows how to apply the version and culture attributes to an assembly.

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")];
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")];
// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")]
' Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
' Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>

Attributi informativiInformational Attributes

Gli attributi informativi consentono di fornire informazioni aggiuntive relative alla società o al prodotto per un assembly.You can use informational attributes to provide additional company or product information for an assembly. Nella tabella seguente vengono descritti gli attributi informativi che è possibile applicare a un assembly.The following table describes the informational attributes you can apply to an assembly.

Attributo informativoInformational attribute DescrizioneDescription
AssemblyCompanyAttribute Valore stringa in cui viene specificato un nome di società.String value specifying a company name.
AssemblyCopyrightAttribute Valore stringa in cui vengono specificate informazioni relative al copyright.String value specifying copyright information.
AssemblyFileVersionAttribute Valore stringa in cui viene specificato il numero di versione del file Win32.String value specifying the Win32 file version number. L'impostazione predefinita è solitamente la versione dell'assembly.This normally defaults to the assembly version.
AssemblyInformationalVersionAttribute Valore stringa in cui vengono specificate informazioni relative alla versione non usate da Common Language Runtime, quale il numero di versione del prodotto completo.String value specifying version information that is not used by the common language runtime, such as a full product version number. Nota: se questo attributo viene applicato a un assembly, è possibile ottenere la stringa specificata in fase di esecuzione tramite la proprietà Application.ProductVersion.Note: If this attribute is applied to an assembly, the string it specifies can be obtained at run time by using the Application.ProductVersion property. La stringa viene usata anche nel percorso e nella chiave del Registro di sistema specificati dalle proprietà Application.UserAppDataPath e Application.UserAppDataRegistry.The string is also used in the path and registry key provided by the Application.UserAppDataPath and Application.UserAppDataRegistry properties.
AssemblyProductAttribute Valore stringa in cui vengono specificate informazioni relative al prodotto.String value specifying product information.
AssemblyTrademarkAttribute Valore stringa in cui vengono specificate informazioni relative al marchio registrato.String value specifying trademark information.

È possibile visualizzare questi attributi nella pagina delle proprietà di Windows o sostituirli usando l'opzione del compilatore /win32res per specificare un file di risorsa Win32 personalizzato.These attributes can appear on the Windows Properties page of the assembly, or they can be overridden using the /win32res compiler option to specify your own Win32 resource file.

Attributi relativi al manifesto dell'assemblyAssembly Manifest Attributes

Gli attributi relativi al manifesto dell'assembly consentono di fornire informazioni nel manifesto dell'assembly, inclusi il titolo, la descrizione, l'alias predefinito e la configurazione.You can use assembly manifest attributes to provide information in the assembly manifest, including title, description, the default alias, and configuration. Nella tabella seguente vengono descritti gli attributi relativi al manifesto dell'assembly.The following table describes the assembly manifest attributes.

Attributo relativo al manifesto dell'assemblyAssembly manifest attribute DescrizioneDescription
AssemblyConfigurationAttribute Valore stringa che indica la configurazione dell'assembly, ad esempio finale o di debug.String value indicating the configuration of the assembly, such as Retail or Debug. Questo valore non viene usato da Common Language Runtime.The runtime does not use this value.
AssemblyDefaultAliasAttribute Valore stringa in cui viene specificato l'alias predefinito che verrà usato dagli assembly contenenti riferimenti all'assembly corrente.String value specifying a default alias to be used by referencing assemblies. Questo valore consente di fornire un nome descrittivo nel caso in cui il nome dell'assembly non sia descrittivo, ma corrisponda ad esempio a un valore GUID.This value provides a friendly name when the name of the assembly itself is not friendly (such as a GUID value). È inoltre possibile usare questo valore come forma abbreviata del nome completo dell'assembly.This value can also be used as a short form of the full assembly name.
AssemblyDescriptionAttribute Valore stringa in cui viene specificata una breve descrizione che riassume la natura e lo scopo dell'assembly.String value specifying a short description that summarizes the nature and purpose of the assembly.
AssemblyTitleAttribute Valore stringa in cui viene specificato un nome descrittivo per l'assembly.String value specifying a friendly name for the assembly. È ad esempio possibile che il titolo di un assembly denominato comdlg sia Controllo della finestra di dialogo comune Microsoft.For example, an assembly named comdlg might have the title Microsoft Common Dialog Control.

Attributi relativi al nome sicuroStrong Name Attributes

Gli attributi relativi al nome sicuro consentono di impostare un nome sicuro per un assembly.You can use strong name attributes to set a strong name for an assembly. Nella tabella seguente vengono descritti gli attributi relativi al nome sicuro.The following table describes the strong name attributes.

Attributi relativi al nome sicuroStrong name attributes DescrizioneDescription
AssemblyDelaySignAttribute Valore booleano che indica che viene usato il ritardo della firma.Boolean value indicating that delay signing is being used.
AssemblyKeyFileAttribute Valore stringa che indica il nome del file contenente la chiave pubblica (se si usa il ritardo della firma) o la chiave pubblica e privata passate come parametro al costruttore di questo attributo.String value indicating the name of the file that contains either the public key (if using delay signing) or both the public and private keys passed as a parameter to the constructor of this attribute. Si noti che il nome del file è relativo al percorso del file di output (il file EXE o DLL), non al percorso del file di origine.Note that the file name is relative to the output file path (the .exe or .dll), not the source file path.
AssemblyKeyNameAttribute Indica il contenitore di chiave contenente la coppia di chiavi passata come parametro al costruttore dell'attributo.Indicates the key container that contains the key pair passed as a parameter to the constructor of this attribute.

Nell'esempio di codice seguente vengono mostrati gli attributi da applicare quando si usa il ritardo della firma per creare un assembly con nome sicuro con un file di chiave pubblica denominato myKey.snk.The following code example shows the attributes to apply when using delay signing to create a strong-named assembly with a public key file called myKey.snk.

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];
[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]
<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

Vedere ancheSee Also

Creazione degli assemblyCreating Assemblies
Programmazione con gli assemblyProgramming with Assemblies