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ść uaktualnienia przechowywanych ustawień zgodnie z potrzebami.
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 równoległą instalację i wykonywanie różnych wersji tej samej aplikacji. Dostawca ustawień aplikacji przechowuje ustawienia aplikacji dla każdej wersji aplikacji oddzielnie, aby zapewnić izolację. Możesz jednak przeprowadzić migrację ustawień z poprzedniej wersji aplikacji do bieżącej wersji. Aby zapewnić tę funkcję migracji, użyj Upgrade metody zaimplementowanej w klasie pochodzącej z SettingsProviderklasy .
Można użyć Upgrade metody w połączeniu z GetPreviousVersion metodą do migrowania ustawień aplikacji podczas lub po instalacji nowej wersji aplikacji.
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 .
