IApplicationSettingsProvider.Upgrade Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wskazuje dostawcę, że aplikacja została uaktualniona. Oferuje to dostawcy możliwość odpowiedniego uaktualnienia przechowywanych ustawień.
public:
void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);public void Upgrade (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unitPublic Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)Parametry
- context
- SettingsContext
Opis SettingsContext bieżącego użycia aplikacji.
- properties
- SettingsPropertyCollection
Element SettingsPropertyCollection zawierający grupę właściwości ustawień, której wartości mają zostać pobrane.
Uwagi
.NET Framework umożliwia instalację równoległą i wykonywanie różnych wersji tej samej aplikacji. Dostawca ustawień aplikacji przechowuje ustawienia aplikacji dla każdej wersji aplikacji oddzielnie, aby zapewnić izolację. Można jednak przeprowadzić migrację ustawień z poprzedniej wersji aplikacji do bieżącej. Aby zapewnić tę funkcję migracji, użyj Upgrade metody zaimplementowanej w klasie pochodnej z SettingsProviderklasy .
Możesz użyć metody w połączeniu Upgrade z GetPreviousVersion metodą , aby przeprowadzić migrację ustawień aplikacji podczas instalacji nowej wersji aplikacji lub po jej zakończeniu.
Ta metoda powinna zostać pominięta dla każdego ustawienia aplikacji, do którego zastosowano NoSettingsVersionUpgradeAttribute element , lub do całej klasy otoki ustawień pochodzącej z ApplicationSettingsBaseklasy .