Usare gli attributi AssemblyVersion e AssemblyFileVersion

Questo articolo illustra come usare AssemblyVersion gli attributi e AssemblyFileVersion nel file AssemblyInfo.cs.

Versione originale del prodotto: .NET Framework
Numero KB originale: 556041

Riepilogo

AssemblyInfo.cs fornisce due attributi per impostare due tipi diversi di versioni. Questo suggerimento illustra come usare questi due attributi.

Microsoft .NET Framework offre l'opportunità di impostare due diversi tipi di numeri di versione su ogni assembly.

AssemblyVersion

È il numero di versione usato dal framework durante la compilazione e in fase di esecuzione per individuare, collegare e caricare gli assembly. Quando si aggiunge un riferimento a qualsiasi assembly nel progetto, si tratta di questo numero di versione che viene incorporato. In fase di esecuzione, Common Language Runtime (CLR) cerca l'assembly con questo numero di versione da caricare. Tenere tuttavia presente che questa versione viene usata insieme a nome, token di chiave pubblica e informazioni sulle impostazioni cultura solo se gli assembly sono firmati con nome sicuro. Se gli assembly non sono firmati con nome sicuro, vengono usati solo i nomi di file per il caricamento.

AssemblyFileVersion

È il numero di versione assegnato al file come nel file system. Viene visualizzato da Esplora risorse e non viene mai usato da .NET Framework o dal runtime per fare riferimento.

Attributi in AssemblyInfo.cs

// Version information for an assembly consists of the following four values:
// Major Version
// Minor Version
// Build Number
// Revision
[assembly: AssemblyVersion("1.0.0.0")]  
[assembly: AssemblyFileVersion("1.0.0.0")]

Se si specifica un (*) al posto di un numero assoluto, il compilatore aumenta il numero di uno ogni volta che si compila.

Si supponga di creare un assembly del framework per il progetto usato da molti sviluppatori durante la compilazione degli assembly dell'applicazione. Se si rilascia frequentemente una nuova versione dell'assembly, ad esempio una volta al giorno e se gli assembly sono denominati con nome sicuro, gli sviluppatori dovranno modificare il riferimento ogni volta che si rilascia un nuovo assembly. Può essere complesso e può causare riferimenti errati anche. Un'opzione migliore in questi scenari chiusi e volatili consiste nel correggere e AssemblyVersion modificare solo .AssemblyFileVersion Usare il numero di versione del file di assembly per comunicare la versione più recente dell'assembly. In questo caso, gli sviluppatori non dovranno modificare i riferimenti e possono sovrascrivere l'assembly nel percorso di riferimento. Nelle build centrali o finali è più opportuno modificare e mantenere la stessa versione dell'assembly AssemblyVersion AssemblyFileVersion .