System.Resources.SatelliteContractVersionAttribute-Klasse

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

In Desktop Apps legt das Attribut SatelliteContractVersionAttribute einen Vertrag zwischen einer Main Assembly und all ihren Satelliten fest. Sie wenden dieses Attribut auf Ihre Main Assembly an und übergeben ihr die Versionsnummer der Satelliten-Assemblies, die mit dieser Version der Main Assembly zusammenarbeiten werden. Wenn der Ressourcen-Manager (ResourceManager Objekt) Ressourcen sucht, lädt er explizit die durch dieses Attribut angegebene Satellitenversion in der Hauptassembly.

Wenn Sie die Hauptassembly aktualisieren, erhöhen Sie die Assemblyversionsnummer. Möglicherweise möchten Sie jedoch keine neuen Kopien Ihrer Satellitenassemblys versenden, wenn die vorhandenen mit Ihrer App kompatibel sind. Erhöhen Sie in diesem Fall die Versionsnummer der Hauptassembly, lassen Sie jedoch die Satellitenvertragsversionsnummer unverändert. Der Resource Manager verwendet Ihre bestehenden Satelliten-Assemblies.

Wenn Sie eine Satellitenassembly, aber nicht die Hauptassembly überarbeiten möchten, erhöhen Sie die Versionsnummer auf Ihrem Satelliten. Bereitstellen Sie in diesem Fall eine Publisher-Policy-Assembly zusammen mit Ihrer Satellitenassembly, um anzugeben, dass Ihre neue Satellitenassembly abwärtskompatibel mit Ihrer alten Satellitenassembly ist. Der Resource Manager verwendet weiterhin die alte Vertragsnummer, die auf der Grundlage des SatelliteContractVersionAttribute-Attributs in Ihre Main Assembly geschrieben wurde. Der Lader bindet sich jedoch an die Version der Satelliten-Assembly, die von der Richtlinie Assembly angegeben wird.

Ein Hersteller einer gemeinsam genutzten Komponente verwendet eine Publisher-Richtlinien-Assembly, um eine Kompatibilitätsaussage über eine bestimmte Version einer veröffentlichten Assembly zu machen. Eine Publisher Policy Assembly ist eine stark benannte Assembly, die einen Namen im Format policy.<major>.<minor>.<ComponentAssemblyName> hat und im Global Assembly Cache (GAC) registriert ist. Die Herausgeberrichtlinie wird aus einer XML-Konfigurationsdatei (siehe das <bindingRedirect> Element) mithilfe des Al.exe (Assembly Linker) Tools generiert. Der Assemblylinker wird mit der Option verwendet, die /link XML-Konfigurationsdatei mit einer Manifestassembly zu verknüpfen, die dann im globalen Assemblycache gespeichert wird. Die Publisher Policy Assemblys können verwendet werden, wenn ein Hersteller eine Wartungsversion (Service Pack) veröffentlicht, die Fehlerkorrekturen enthält.

Windows 8.x-Apps aus dem Store

Dieses Attribut wird in Windows 8.x Store-Apps ignoriert, da Paketressourcenindexdateien (PRI) keine Versionsverwaltungssemantik aufweisen. Darüber hinaus erfordert das Windows 8.x Store-Paketmodell, dass alle Ressourcen im selben Paket ausgeliefert werden, ohne die Möglichkeit der erneuten Bereitstellung von Satellitenassemblys oder PRI-Dateien.