Classe System.Resources.SatelliteContractVersionAttribute

Questo articolo fornisce osservazioni supplementari alla documentazione di riferimento per questa API.

Nelle app desktop, l'attributo SatelliteContractVersionAttribute stabilisce un contratto tra un assembly principale e tutti i relativi satelliti. Si applica questo attributo all'assembly principale e si passa il numero di versione degli assembly satellite che funzioneranno con questa versione dell'assembly principale. Quando resource manager (ResourceManager oggetto) cerca le risorse, carica in modo esplicito la versione satellite specificata da questo attributo nell'assembly principale.

Quando si aggiorna l'assembly principale, si incrementa il numero di versione dell'assembly. Tuttavia, potresti non voler spedire nuove copie degli assembly satellite se quelle esistenti sono compatibili con la tua app. In questo caso, incrementare il numero di versione dell'assembly principale, ma lasciare invariato il numero di versione del contratto satellite. Resource Manager userà gli assembly satellite esistenti.

Se si desidera modificare un assembly satellite ma non l'assembly principale, incrementare il numero di versione sul satellite. In questo caso, spedire un assembly dei criteri dell'editore insieme all'assembly satellite che informa che il nuovo assembly satellite ha compatibilità con le versioni precedenti con l'assembly satellite precedente. Il gestore risorse userà comunque il numero di contratto precedente scritto nell'assembly principale in base all'attributo SatelliteContractVersionAttribute . Tuttavia, il caricatore verrà associato alla versione dell'assembly satellite specificata dall'assembly dei criteri.

Un fornitore di un componente condiviso usa un assembly dei criteri di pubblicazione per creare un'istruzione di compatibilità relativa a una determinata versione di un assembly rilasciato. Un assembly dei criteri di pubblicazione è un assembly con nome sicuro con un nome nel formato policy.<major>.<minor>.<ComponentAssemblyName>e registrato nella Global Assembly Cache (GAC). I criteri dell'editore vengono generati da un file di configurazione XML (vedere l'elemento< bindingRedirect>) usando lo strumento Al.exe (Assembly Linker). Il linker assembly viene usato con l'opzione /link per collegare il file di configurazione XML a un assembly manifesto, che viene quindi archiviato nella Global Assembly Cache. Gli assembly dei criteri dell'editore possono essere usati quando un fornitore fornisce una versione di manutenzione (Service Pack) che contiene correzioni di bug.

App di Windows 8.x Store

Questo attributo viene ignorato nelle app di Windows 8.x Store, perché i file PRI (Package Resource Index) non hanno una semantica di controllo delle versioni. Inoltre, il modello di creazione di pacchetti di Windows 8.x Store richiede che tutte le risorse vengono fornite nello stesso pacchetto, senza possibilità di ridistribuire assembly satellite o file PRI.