Attributi a livello di assembly interpretati dal compilatore C#
La maggior parte degli attributi viene applicata a elementi specifici del linguaggio quali classi o metodi. Alcuni attributi sono invece globali e vengono applicati a un intero assembly o a un intero modulo. Ad esempio, l'attributo AssemblyVersionAttribute può essere usato per incorporare informazioni sulla versione in un assembly, nel modo seguente:
[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. Gli attributi globali possono apparire in più file di origine, ma i file devono essere compilati in un'unica operazione di compilazione. Visual Studio aggiunge attributi globali al file AssemblyInfo.cs nei progetti .NET Framework. Questi attributi non vengono aggiunti ai progetti .NET Core.
Gli attributi dell'assembly sono valori che forniscono informazioni relative a 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 usare gli attributi per impostare la versione e le impostazioni cultura di un assembly. Tuttavia il valore del nome viene impostato dal compilatore, l'IDE di Visual Studio nella finestra di dialogo informazioni Assembly oppure Assembly Linker (Al.exe) quando viene creato dell'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
Gli attributi informativi vengono usati per fornire altre informazioni aggiuntive 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
È possibile usare gli attributi relativi al manifesto dell'assembly per includere 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. |
