Versionsnummern für Hauptassemblys und lokalisierte Satellitenassemblys
Aktualisiert: November 2007
Die SatelliteContractVersionAttribute-Klasse stellt Versionsunterstützung für eine Hauptassembly bereit, die mithilfe des Ressourcenmanagers lokalisierte Ressourcen verwendet. Durch die Anwendung von SatelliteContractVersionAttribute in der Hauptassembly einer Anwendung kann die Hauptassembly aktualisiert und erneut bereitgestellt werden, ohne ihre Satellitenassemblys aktualisieren zu müssen. Sie können z. B. die SatelliteContractVersionAttribute-Klasse mit einem Service Pack verwenden, das keine neuen Ressourcen einbringt, ohne die Satellitenassemblys erneut erstellen und bereitstellen zu müssen. Damit lokalisierte Ressourcen verfügbar sind, muss die Satellitenvertragsversion der Hauptassembly mit der AssemblyVersionAttribute-Klasse der Satellitenassemblys übereinstimmen. Sie müssen in SatelliteContractVersionAttribute eine genaue Versionsnummer angeben. Platzhalterzeichen, z. B. "*", sind nicht zulässig. Weitere Informationen finden Sie unter Abrufen von Ressourcen in Satellitenassemblys.
Aktualisieren von Assemblys
Mithilfe der SatelliteContractVersionAttribute-Klasse können Sie eine Hauptassembly aktualisieren, ohne die Satellitenassemblys ebenfalls aktualisieren zu müssen, und umgekehrt. Nachdem die Hauptassembly aktualisiert wurde, wird ihre Assemblyversionsnummer geändert. Wenn Sie die vorhandenen Satellitenassemblys weiterhin verwenden möchten, ändern Sie die Versionsnummer der Hauptassembly, behalten aber die Nummer der Satellitenvertragsversion bei. Angenommen, bei der ersten Release ist die Hauptassemblyversion 1.0.0.0. Die Satellitenvertragsversion und die Assemblyversion der Satellitenassembly sind dann ebenfalls 1.0.0.0. Wenn Sie die Hauptassembly mit einem Service Pack aktualisieren müssen, können Sie die Assemblyversion in 1.0.0.1 ändern, während die Satellitenvertragsversion und die Version der Satellitenassembly weiterhin 1.0.0.0 bleiben.
Wenn Sie eine Satellitenassembly aktualisieren, ohne dass die Hauptversion aktualisiert werden muss, ändern Sie das AssemblyVersionAttribute der Satellitenassembly. Zusammen mit der Satellitenassembly müssen Sie eine Richtlinienassembly ausliefern, die angibt, dass die neue Satellitenassembly mit der bisherigen Satellitenassembly kompatibel ist. Weitere Informationen zu Richtlinien finden Sie unter So sucht Common Language Runtime nach Assemblys.
Der folgende Code zeigt das Festlegen der Satellitenvertragsversion. Der Code kann entweder in ein Buildscript, in die Datei AssemblyInfo.vb oder die Datei AssemblyInfo.cs eingefügt werden.
<Assembly: SatelliteContractVersionAttribute("4.3.2.1")>
[assembly: SatelliteContractVersionAttribute("4.3.2.1")]
Siehe auch
Konzepte
So sucht Common Language Runtime nach Assemblys
Festlegen von Assemblyattributen
Sicherheit und lokalisierte Satellitenassemblys