System.Resources.SatelliteContractVersionAttribute, klasa

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

W aplikacjach desktopowych SatelliteContractVersionAttribute atrybut ustanawia kontrakt między głównym zestawem a wszystkimi jego satelitami. Aplikujesz ten atrybut do głównego zestawu i określasz numer wersji zestawów satelickich, które będą współdziałać z tą wersją głównego zestawu. Gdy menedżer zasobów (ResourceManager obiekt) wyszukuje zasoby, jawnie ładuje wersję satelitarną określoną przez ten atrybut w głównym zestawie.

Podczas aktualizowania głównego zestawu zwiększa się numer jego wersji. Możesz jednak nie chcieć wysłać nowych kopii zestawów satelitarnych, jeśli istniejące są zgodne z twoją aplikacją. W takim przypadku zwiększ numer wersji głównego zestawu, pozostawiając bez zmian numer wersji kontraktu satelitarnego. Menedżer zasobów będzie używać istniejących zestawów satelitarnych.

Jeśli chcesz skorygować zestaw satelitarny, ale nie główny zestaw, zwiększ numer wersji na satelicie. W takim przypadku należy wysłać zestaw zasad wydawcy wraz z zestawem satelitarnym z informacją, że nowy zestaw satelitarny ma zgodność wsteczną ze starym zestawem satelitarnym. Menedżer zasobów będzie nadal używać starego numeru kontraktu zapisanego w głównym zestawie na podstawie atrybutu SatelliteContractVersionAttribute, jednak program ładujący będzie wiązać się z wersją zestawu satelitarnego określoną przez zestaw zasad.

Dostawca składnika udostępnionego używa zestawu zasad wydawcy, aby utworzyć instrukcję zgodności dotyczącą określonej wersji wydanego zestawu. Silnie nazwany zestaw zasad wydawcy to zestaw, który ma nazwę w formacie policy.<major>.<minor>.<ComponentAssemblyName>, i jest zarejestrowany w globalnej pamięci podręcznej zestawów (GAC). Polityka wydawcy jest generowana na podstawie pliku konfiguracji XML (zobacz <bindingRedirect> element) przy użyciu narzędzia Al.exe (Konsolidator zestawu). Łączenie zestawów jest używane z opcją /link do powiązania pliku konfiguracji XML z zestawem manifestu, który jest następnie przechowywany w globalnej pamięci podręcznej zestawów. Zestawy zasad wydawcy mogą być używane, gdy dostawca dostarcza wydanie konserwacji (Service Pack), które zawiera poprawki błędów.

Aplikacje ze Sklepu Windows 8.x

Ten atrybut jest ignorowany w aplikacjach ze Sklepu Windows 8.x, ponieważ pliki indeksu zasobów pakietu (PRI) nie mają semantyki przechowywania wersji. Ponadto model pakowania sklepu Windows 8.x wymaga wszystkich zasobów do wysłania w tym samym pakiecie, bez możliwości ponownego wdrażania zestawów satelickich ani plików PRI.