SatelliteContractVersionAttribute-Klasse

Weist den ResourceManager an, eine bestimmte Version einer Satellitenassembly anzufordern, um das Aktualisieren der Hauptassembly einer Anwendung zu vereinfachen.

Namespace: System.Resources
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple:=False)> _
Public NotInheritable Class SatelliteContractVersionAttribute
    Inherits Attribute
'Usage
Dim instance As SatelliteContractVersionAttribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple=false)] 
public sealed class SatelliteContractVersionAttribute : Attribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Assembly, AllowMultiple=false)] 
public ref class SatelliteContractVersionAttribute sealed : public Attribute

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple=false) */ 
public final class SatelliteContractVersionAttribute extends Attribute

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple=false) 
public final class SatelliteContractVersionAttribute extends Attribute

Hinweise

Das SatelliteContractVersionAttribute stellt einen Vertrag zwischen einer Hauptassembly und allen zugehörigen Satelliten her. Wenn der ResourceManager nach Ressourcen sucht, lädt er explizit die von diesem Attribut für die Hauptassembly angegebene Satellitenversion. Auf diese Weise kann eine Dereferenzierungsebene Versionsszenarien einfacher erstellen.

Beim Aktualisieren der Hauptassembly wird deren Assemblyversionsnummer inkrementiert. Möglicherweise möchten Sie neue Kopien der Satellitenassemblys nicht versenden, wenn die vorhandenen Satellitenassemblys bereits ausreichen und mit der neueren Version Ihres Produkts kompatibel sind. In diesem Fall inkrementieren Sie die Versionsnummer der Hauptassembly, behalten jedoch die Versionsnummer des Satellitenvertrags bei. Der ResourceManager verwendet die vorhandenen Satellitenassemblys.

Wenn Sie eine Satellitenassembly, jedoch nicht die Hauptassembly bearbeiten müssen, müssen Sie die Versionsnummer des Satelliten inkrementieren. In diesem Fall versenden Sie zusammen mit der Satellitenassembly eine Richtlinienassembly, die angibt, dass die neue Satellitenassembly mit der alten Satellitenassembly abwärtskompatibel ist. Der ResourceManager verwendet weiterhin die alte in die Hauptassembly geschriebene Vertragsnummer, wobei das Ladeprogramm jedoch an die Version der Satellitenassembly bindet, die von der Richtlinienassembly angegeben ist.

Mithilfe einer Assembly für Herausgeberrichtlinien stellt der Anbieter einer gemeinsam verwendeten Komponente Hinweise über die Kompatibilität einer bestimmten Version einer freigegebenen Assembly bereit. Eine Assembly für Herausgeberrichtlinien ist eine Assembly mit starkem Namen im Format policy.<major>.<minor>.<ComponentAssemblyName> und ist im Globaler Assemblycache (GAC, globaler Assemblycache) registriert. Die Herausgeberrichtlinie wird unter Verwendung des Assembly Linker-Tool (Al.exe)-Tools aus einer XML-Konfigurationsdatei generiert (siehe <bindingRedirect>-Element). Das Assembly Linker-Tool wird mit der /link-Option verwendet, um die XML-Konfigurationsdatei mit einer Manifestassembly zu verknüpfen, die anschließend im GAC gespeichert wird. Die Verwendung von Assemblys für Herausgeberrichtlinien ist möglich, wenn ein Hersteller eine Wartungsversion (Service Pack) mit Lösungen für Programmfehler anbietet.

Hinweis

Wenden Sie dieses Attribut auf die Hauptassembly an, wobei Sie dieser die Versionsnummer der Satellitenassembly übergeben, die für diese Version der Hauptassembly verwendet wird.

Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: Obwohl .NET Compact Framework SatelliteContractVersionAttribute unterstützt, ist dessen Implementierung für eine künftige Version reserviert.

Vererbungshierarchie

System.Object
   System.Attribute
    System.Resources.SatelliteContractVersionAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SatelliteContractVersionAttribute-Member
System.Resources-Namespace