Attributi a livello di assembly interpretati dal compilatore C#

La maggior parte degli attributi si applica a elementi del linguaggio specifici, ad esempio classi o metodi. Tuttavia, alcuni attributi sono globali. Si applicano a un intero assembly o modulo. Ad esempio, usare l'attributo AssemblyVersionAttribute per incorporare le informazioni sulla versione in un assembly, come illustrato di seguito:

[assembly: AssemblyVersion("1.0.0.0")]

Gli attributi globali appaiono nel codice sorgente dopo eventuali direttive using di primo livello e prima delle dichiarazioni di tipo, modulo o spazio dei nomi. È possibile includere attributi globali in più file di origine, ma è necessario compilare i file in un singolo passaggio di compilazione. Nei progetti .NET Framework Visual Studio aggiunge attributi globali al file AssemblyInfo.cs. Questi attributi non vengono aggiunti ai progetti .NET Core.

Il riferimento al linguaggio C# documenta la versione rilasciata più di recente del linguaggio C#. Contiene anche la documentazione iniziale per le funzionalità nelle anteprime pubbliche per la versione futura del linguaggio.

La documentazione identifica tutte le funzionalità introdotte nelle ultime tre versioni della lingua o nelle anteprime pubbliche correnti.

Suggerimento

Per trovare quando una funzionalità è stata introdotta per la prima volta in C#, vedere l'articolo sulla cronologia delle versioni del linguaggio C#.

Gli attributi dell'assembly forniscono informazioni su un assembly. Sono suddivisi nelle seguenti categorie:

• Attributi relativi all'identità dell'assembly
• Attributi informativi
• Attributi relativi al manifesto dell'assembly

Attributi relativi all'identità dell'assembly

Tre attributi (con un nome sicuro, se disponibile), consentono di determinare l'identità di un assembly: il nome, la versione e le impostazioni cultura. Questi attributi formano il nome completo dell'assembly e sono necessari per creare riferimenti all'assembly nel codice. È possibile impostare la versione e le impostazioni cultura di un assembly usando gli attributi. Tuttavia, il valore del nome viene impostato dal compilatore, dall'IDE di Visual Studio nella finestra di dialogo Informazioni assembly o dal linker assembly (Al.exe) quando si crea l'assembly. Il nome dell'assembly si basa sul manifesto dell'assembly. L'attributo AssemblyFlagsAttribute specifica se è supportata la coesistenza di più copie dell'assembly.

La tabella seguente visualizza gli attributi relativi all'identità.

Attributo	Scopo
AssemblyVersionAttribute	Specifica la versione di un assembly.
AssemblyCultureAttribute	Specifica le impostazioni cultura supportate dall'assembly.
AssemblyFlagsAttribute	Specifica una combinazione bit per bit di flag per un assembly, indicando le opzioni del compilatore JIT (Just-In-Time), se è possibile assegnare una nuova destinazione all'assembly e se questo dispone di una chiave pubblica completa o in formato token.

Attributi informativi

Usare gli attributi informativi per fornire più informazioni sulla società o sul prodotto per un assembly. La tabella seguente mostra gli attributi informativi definiti nello spazio dei nomi System.Reflection.

Attributo	Scopo
AssemblyProductAttribute	Specifica il nome di un prodotto per un manifesto dell'assembly.
AssemblyTrademarkAttribute	Specifica un marchio per un manifesto dell'assembly.
AssemblyInformationalVersionAttribute	Specifica una versione informativa per un manifesto dell'assembly.
AssemblyCompanyAttribute	Specifica il nome di una società per un manifesto dell'assembly.
AssemblyCopyrightAttribute	Definisce un attributo personalizzato che specifica un copyright per un manifesto dell'assembly.
AssemblyFileVersionAttribute	Imposta un numero di versione specifico per la risorsa della versione del file Win32.
CLSCompliantAttribute	Indica se l'assembly è conforme a CLS (Common Language Specification).

Attributi relativi al manifesto dell'assembly

Usare gli attributi del manifesto dell'assembly per fornire informazioni nel manifesto dell'assembly. Gli attributi includono titolo, descrizione, alias predefinito e configurazione. La tabella seguente visualizza gli attributi del manifesto dell'assembly definiti nello spazio dei nomi System.Reflection.

Attributo	Scopo
AssemblyTitleAttribute	Specifica un titolo dell'assembly per un manifesto dell'assembly.
AssemblyDescriptionAttribute	Specifica una descrizione dell'assembly per un manifesto dell'assembly.
AssemblyConfigurationAttribute	Specifica una configurazione dell'assembly, ad esempio retail o debug, per un manifesto dell'assembly.
AssemblyDefaultAliasAttribute	Definisce un alias predefinito descrittivo per un manifesto dell'assembly.