Klasse System.Resources.SatelliteContractVersionAttribute

Opmerking

In dit artikel vindt u aanvullende opmerkingen in de referentiedocumentatie voor deze API.

In desktop-apps brengt het SatelliteContractVersionAttribute kenmerk een contract tot stand tussen een hoofdassembly en alle satellieten. U past dit kenmerk toe op uw hoofdassembly en geeft dit door aan het versienummer van de satellietassembly's die met deze versie van de hoofdassembly werken. Wanneer de resourcemanager (ResourceManager object) resources opzoekt, wordt de satellietversie die door dit kenmerk is opgegeven, expliciet in de hoofdassembly geladen.

Wanneer u de hoofdassembly bijwerkt, wordt het versienummer van de assembly verhoogd. Mogelijk wilt u echter geen nieuwe kopieën van uw satellietassembly's verzenden als de bestaande exemplaren compatibel zijn met uw app. In dit geval moet u het versienummer van de hoofdassembly verhogen, maar het versienummer van het satellietcontract hetzelfde laten. De resourcemanager gebruikt uw bestaande satellietassemblies.

Als u een satellietassembly wilt herzien, maar niet de hoofdassembly, moet u het versienummer op uw satelliet verhogen. Verzend in dit geval een uitgeversbeleidsassembly samen met uw satellietassembly, waarin staat dat uw nieuwe satellietassembly achterwaartse compatibiliteit heeft met uw oude satellietassembly. De resourcemanager gebruikt nog steeds het oude contractnummer dat is geschreven in uw hoofdassembly op basis van het SatelliteContractVersionAttribute kenmerk. Het laadprogramma verbindt echter met de satellietassemblyversie die is opgegeven door de beleidsassembly.

Een leverancier van een gedeeld onderdeel gebruikt een assembly voor publicatiebeleid om een compatibiliteitsverklaring af te geven over een bepaalde versie van een vrijgegeven assembly. Een assembly voor uitgeversbeleid is een sterk benoemde assembly met een naam in de indeling policy.<major>.<minor>.<ComponentAssemblyName>, en is geregistreerd in de Global Assembly Cache (GAC). Het uitgeversbeleid wordt gegenereerd op basis van een XML-configuratiebestand (zie het <bindingRedirect> element) met behulp van het hulpprogramma Al.exe (Assembly Linker). De Assembly Linker wordt gebruikt met de /link optie om het XML-configuratiebestand te koppelen aan een manifestassembly, die vervolgens wordt opgeslagen in de algemene assemblycache. De uitgeversbeleidassembly's kunnen worden gebruikt wanneer een leverancier een onderhoudsrelease (servicepack) verzendt die bugfixes bevat.

Windows 8.x Store-apps

Dit kenmerk wordt genegeerd in Windows 8.x Store-apps, omdat pakketresourceindexbestanden (PRI) geen semantiek voor versiebeheer hebben. Bovendien vereist het windows 8.x Store-verpakkingsmodel dat alle resources in hetzelfde pakket moeten worden verzonden, zonder dat het mogelijk is om satellietassembly's of PRI-bestanden opnieuw te implementeren.