System.Resources.SatelliteContractVersionAttribute-Klasse

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

In Desktop-Apps richtet das SatelliteContractVersionAttribute Attribut einen Vertrag zwischen einer Standard-Assembly und allen seinen Satelliten ein. Sie wenden dieses Attribut auf Ihre Standard Assembly an und übergeben sie die Versionsnummer der Satellitenassemblys, die mit dieser Version der Standard-Assembly funktionieren. Wenn der Ressourcen-Manager (ResourceManager Objekt) Ressourcen nachsieht, lädt er explizit die durch dieses Attribut angegebene Satellitenversion für die Standard Assembly.

Wenn Sie die Standard Assembly 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 Standard Assembly, lassen sie aber die Satellitenvertragsnummer unverändert. Der Ressourcenmanager verwendet Ihre vorhandenen Satellitenassemblys.

Wenn Sie eine Satellitenassembly, aber nicht die Standard-Assembly ändern möchten, erhöhen Sie die Versionsnummer auf Ihrem Satelliten. Versenden Sie in diesem Fall eine Herausgeberrichtlinienassembly zusammen mit Ihrer Satellitenassembly, die besagt, dass Ihre neue Satellitenassembly abwärtskompatibel mit Ihrer alten Satellitenassembly ist. Der Ressourcenmanager verwendet weiterhin die alte Vertragsnummer, die basierend auf dem SatelliteContractVersionAttribute Attribut in Ihre Standard-Assembly geschrieben wurde. Der Ladeprogramm wird jedoch an die Satellitenassemblyversion gebunden, die von der Richtlinienassembly angegeben wird.

Ein Anbieter einer freigegebenen Komponente verwendet eine Herausgeberrichtlinienassembly, um eine Kompatibilitätsanweisung zu einer bestimmten Version einer freigegebenen Assembly zu erstellen. Eine Herausgeberrichtlinienassembly ist eine stark benannte Assembly mit einem Namen im Format policy.<major>.<minor>.<ComponentAssemblyName>und wird im globalen Assemblycache (GAC) registriert. Die Herausgeberrichtlinie wird aus einer XML-Konfigurationsdatei (siehe bindingRedirect-Element<>) mithilfe des Tools Al.exe (Assembly Linker) 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 Herausgeberrichtlinienassemblys können verwendet werden, wenn ein Anbieter eine Standard Tenance Release (Service Pack) enthält, die Fehlerbehebungen enthält.

Windows 8.x Store-Apps

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 alle Ressourcen, die im selben Paket ausgeliefert werden müssen, ohne dass Satellitenassemblys oder PRI-Dateien erneut bereitgestellt werden können.