Versionamento degli assembly

Tutto il controllo delle versioni degli assembly che usano Common Language Runtime viene eseguito a livello di assembly. La versione specifica di un assembly e le versioni degli assembly da cui dipende vengono registrate nel manifesto dell'assembly. Il criterio di versione predefinito per il runtime è che le applicazioni vengono eseguite solo con le versioni compilate e testate con, a meno che non vengano sottoposte a override da criteri di versione espliciti nei file di configurazione (il file di configurazione dell'applicazione, il file dei criteri dell'editore e il file di configurazione dell'amministratore del computer).

Il runtime compie diversi passaggi per risolvere una richiesta di associazione di assembly.

1. Controlla il riferimento all'assembly originale per determinare la versione dell'assembly da associare.

2. Verifica la presenza di tutti i file di configurazione applicabili per applicare i criteri di versione.

3. Determina l'assembly corretto in base al riferimento dell'assembly originale e a qualsiasi reindirizzamento indicato nei file di configurazione, e determina la versione che deve essere collegata all'assembly chiamante.

4. Controlla la Global Assembly Cache, le codebase specificate nei file di configurazione e quindi controlla la directory e le sottodirectory dell'applicazione usando le regole di probe illustrate in Come il runtime individua gli assembly.

La figura seguente illustra questi passaggi:

Per altre informazioni sulla configurazione delle applicazioni, vedere Configurare le app. Per altre informazioni sui criteri di associazione, vedere Come il runtime individua gli assembly.

Informazioni sulla versione

Ogni assembly ha due modi distinti per esprimere le informazioni sulla versione:

• Il numero di versione dell'assembly è, insieme alle informazioni sul nome dell'assembly e sulle informazioni cultura, parte dell'identità dell'assembly. Questo numero viene usato dal runtime per applicare i criteri di versione e svolge una parte fondamentale nel processo di risoluzione dei tipi in fase di esecuzione.

• Una versione informativa, ovvero una stringa che rappresenta informazioni aggiuntive sulla versione incluse solo a scopo informativo.

Numero di versione dell'assembly

Ogni assembly ha un numero di versione come parte della relativa identità. Di conseguenza, due assembly che differiscono in base al numero di versione vengono considerati dal runtime come assembly completamente diversi. Questo numero di versione è rappresentato fisicamente come stringa in quattro parti con il formato seguente:

< versione> principale.<versione> secondaria.<numero di> build.<revisione>

Ad esempio, la versione 1.5.1254.0 indica 1 come versione principale, 5 come versione secondaria, 1254 come numero di build e 0 come numero di revisione.

Il numero di versione viene archiviato nel manifesto dell'assembly insieme ad altre informazioni sull'identità, tra cui il nome dell'assembly e la chiave pubblica, nonché informazioni sulle relazioni e sulle identità di altri assembly connessi all'applicazione.

Quando viene compilato un assembly, lo strumento di sviluppo registra le informazioni sulle dipendenze per ogni assembly a cui viene fatto riferimento nel manifesto dell'assembly. Il runtime usa questi numeri di versione, insieme alle informazioni di configurazione impostate da un amministratore, un'applicazione o un server di pubblicazione, per caricare la versione corretta di un assembly a cui si fa riferimento.

Il runtime distingue tra assembly regolari e assembly a nome forte ai fini della gestione delle versioni. Il controllo della versione si verifica solo per gli assembly con nome sicuro.

Per informazioni sulla specifica dei criteri di associazione delle versioni, vedere Configurare le app. Per informazioni su come il runtime usa le informazioni sulla versione per trovare un assembly specifico, vedere Come il runtime individua gli assembly.

Versione informativa dell'assembly

La versione informativa è una stringa che allega informazioni aggiuntive sulla versione a un assembly solo a scopo informativo; queste informazioni non vengono utilizzate in fase di esecuzione. La versione informativa basata su testo corrisponde alla documentazione di marketing, al packaging del prodotto o al nome del prodotto e non viene utilizzata dal runtime. Ad esempio, una versione informativa potrebbe essere "Common Language Runtime versione 1.0" o "NET Control SP 2". Nella scheda Versione della finestra di dialogo delle proprietà del file in Microsoft Windows queste informazioni vengono visualizzate nell'elemento "Versione prodotto".

La versione informativa è rappresentata usando l'attributo System.Reflection.AssemblyInformationalVersionAttributepersonalizzato . Per altre informazioni sull'attributo della versione informativa, vedere Impostare gli attributi dell'assembly.

Vedere anche

• Come il runtime individua gli assembly
• Configurare le app
• Impostare gli attributi dell'assembly
• Assembly in .NET