Numeri di versione dell'assembly principale e degli assembly satellite localizzati
La classe SatelliteContractVersionAttribute fornisce supporto per il controllo delle versioni per un assembly principale che utilizza risorse localizzate tramite il gestore delle risorse. Applicando la classe SatelliteContractVersionAttribute all'assembly principale di un'applicazione, è possibile aggiornare e ridistribuire l'assembly senza aggiornare i relativi assembly satellite. Ad esempio, è possibile utilizzare la classe SatelliteContractVersionAttribute con un service pack che non consente l'introduzione di nuove risorse senza ricompilare e ridistribuire gli assembly satellite. Per rendere disponibili le risorse localizzate, è necessario che la versione del contratto satellite dell'assembly principale corrisponda alla classe AssemblyVersionAttribute degli assembly satellite. È necessario specificare un numero di versione esatto nella classe SatelliteContractVersionAttribute. I caratteri jolly come "*" non sono consentiti. Per ulteriori informazioni, vedere Recupero di risorse in assembly satellite.
Aggiornamento degli assembly
La classe SatelliteContractVersionAttribute consente di aggiornare un assembly principale senza dover aggiornare l'assembly satellite o viceversa. Quando viene aggiornato l'assembly principale, viene modificato anche il relativo numero di versione dell'assembly. Per continuare a utilizzare gli assembly satellite esistenti, è necessario modificare il numero di versione dell'assembly principale, lasciando tuttavia invariato il numero di versione del contratto satellite. La prima versione dell'assembly principale, ad esempio, può essere 1.0.0.0. La versione del contratto satellite e la versione di assembly dell'assembly satellite saranno pertanto ugualmente 1.0.0.0. Se è necessario aggiornare l'assembly principale di un service pack, è possibile modificare la versione di assembly in 1.0.0.1, lasciando invariata la versione del contratto satellite e la versione di assembly del satellite (1.0.0.0).
Se è necessario aggiornare un assembly satellite, ma non l'assembly principale, modificare la classe AssemblyVersionAttribute dell'assembly satellite. Oltre all'assembly satellite sarà necessario fornire un assembly di criteri in cui viene indicato che il nuovo assembly satellite è compatibile con l'assembly satellite precedente. Per ulteriori informazioni sui criteri, vedere Come il runtime individua gli assembly.
Nel codice riportato di seguito viene illustrato come impostare la versione del contratto satellite. Il codice può essere inserito in uno script di compilazione oppure nel file AssemblyInfo.vb o AssemblyInfo.cs.
<Assembly: SatelliteContractVersionAttribute("4.3.2.1")>
[assembly: SatelliteContractVersionAttribute("4.3.2.1")]
Vedere anche
Concetti
Come il runtime individua gli assembly
Impostazione degli attributi dell'assembly
Sicurezza e assembly satellite localizzati