Controllo delle versioni dell'assembly

Il controllo delle versioni degli assembly che utilizzano Common Language Runtime viene svolto interamente a livello dell'assembly. La specifica versione di un assembly e le versioni degli assembly dipendenti sono memorizzate nel manifesto dell'assembly. I criteri di versione predefiniti del runtime prevedono che l'applicazione venga eseguita solo con le versioni con cui è stata compilata e testata. Per modificare il comportamento predefinito, è possibile esprimere esplicitamente criteri di versione diversi nei file di configurazione (il file di configurazione dell'applicazione, il file dei criteri dell'autore e il file di configurazione dell'amministratore del computer).

Per risolvere una richiesta di associazione di un assembly, il runtime compie diverse operazioni:

1. Controlla il riferimento originale dell'assembly per determinare a quale versione dell'assembly effettuare l'associazione.

2. Controlla tutti i file di configurazione interessati per adottare i criteri di versione prescritti.

3. Sulla base del riferimento originale e di eventuali reindirizzamenti specificati nei file di configurazione, determina la versione dell'assembly da collegare all'assembly che ha effettuato la chiamata.

4. Controlla la Global Assembly Cache e le basi di codice specificate nei file di configurazione, quindi controlla la directory dell'applicazione e le sottodirectory che usano le regole di esecuzione del probe descritte in Come il runtime individua gli assembly.

Questi passaggi sono illustrati nella figura seguente:

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

In ciascun assembly le informazioni sulla versione sono espresse in due modi:

• Il numero di versione dell'assembly, che insieme al nome dell'assembly e alle informazioni sulle impostazioni cultura è parte dell'identità dell'assembly. Tale numero viene utilizzato dal runtime per applicare i criteri di versione e gioca un ruolo determinante nel processo per la risoluzione dei tipi in fase di esecuzione.

• Una versione informativa, cioè una stringa che riporta informazioni aggiuntive sulla versione a fini esclusivamente informativi.

Numero di versione dell'assembly

Tutti gli assembly hanno un numero di versione che concorre a definirne l'identità. Di conseguenza, due assembly che hanno numeri di versione differenti sono considerati dal runtime come due assembly distinti. Il numero di versione è rappresentato fisicamente da una stringa divisa in quattro parti, come indicato di seguito:

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

Versione 1.5.1254.0 indica ad esempio 1 come numero di versione principale, 5 come numero di versione secondario, 1254 come numero di build e 0 come numero di revisione.

Il numero di versione viene memorizzato nel manifesto dell'assembly insieme ad altre informazioni che contribuiscono a definire l'identità dell'assembly, tra cui il nome e la chiave pubblica, le informazioni sulle relazioni e le identità di altri assembly connessi all'applicazione.

Quando si compila un assembly, lo strumento di sviluppo memorizza informazioni sulle dipendenze che riguardano ciascun assembly a cui si fa riferimento nel manifesto dell'assembly. Il runtime utilizza tali numeri di versione, insieme alle informazioni di configurazione impostate da un amministratore, un'applicazione o un autore, per caricare la versione corretta dell'assembly a cui si fa riferimento.

Ai fini del controllo di versione, il runtime distingue tra assembly dotati o meno di nome sicuro. Il controllo di versione viene effettuato solo con assembly con nome sicuro.

Per informazioni su come specificare i criteri di associazione di versione, vedere Configurare le app. Per informazioni sul modo in cui 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 specifica ulteriori informazioni sulla versione di un assembly a fini esclusivamente informativi. Tali informazioni non vengono utilizzate in fase di esecuzione. La versione informativa espressa in testo semplice riporta informazioni commerciali, informazioni sul pacchetto o il nome del prodotto e non viene utilizzata dal runtime. Una versione informativa può ad esempio essere "Common Language Runtime, versione 1.0" o "NET Control SP 2". Nella scheda Versione della finestra di dialogo delle Proprietà file in Microsoft Windows queste informazioni sono visualizzate alla voce "Versione prodotto".

La versione informativa viene espressa utilizzando l'attributo personalizzato System.Reflection.AssemblyInformationalVersionAttribute. Per altre informazioni sull'attributo usato dalla versione informativa, vedere Impostare gli attributi di un assembly.

Vedi anche

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