LocalFileSettingsProvider.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.
Próbuje przeprowadzić migrację poprzednich ustawień o zakresie użytkownika z poprzedniej wersji tej samej aplikacji.
public:
virtual 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 -> unit
override this.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.
Implementuje
Wyjątki
Napotkano ustawienie o zakresie użytkownika, ale bieżąca konfiguracja obsługuje tylko ustawienia o zakresie aplikacji.
-lub-
Nie można uzyskać dostępu do poprzedniej wersji pliku konfiguracji.
Uwagi
LocalFileSettingsProvider migruje ustawienia lokalne i mobilne w oddzielnych operacjach.
Metoda Upgrade jest pomijana dla każdego ustawienia aplikacji, które zostało NoSettingsVersionUpgradeAttribute do niego zastosowane, lub do całej klasy otoki ustawień, pochodzącej z ApplicationSettingsBaseklasy .
W ten sposób wywoływana jest ta metoda zależy od typu uaktualnianej aplikacji:
Każda wersja aplikacji ClickOnce jest przechowywana we własnym izolowanym katalogu instalacyjnym. Po zainstalowaniu nowej wersji aplikacji ClickOnce, a po pierwszym uruchomieniu nowej wersji logika wewnętrzna zostanie automatycznie wywołana Upgrade w celu zmigrowania wszystkich typowych ustawień aplikacji do nowej wersji. Aby uzyskać więcej informacji, zobacz ClickOnce and Application Settings (Ustawienia aplikacji).
Standardowe Windows Forms i aplikacje konsolowe muszą ręcznie wywoływać Upgrademetodę , ponieważ nie ma ogólnego, automatycznego sposobu określania, kiedy taka aplikacja jest uruchamiana po raz pierwszy. Dwa typowe sposoby wykonania tej czynności pochodzą z programu instalacyjnego lub z samej aplikacji przy użyciu utrwalonej właściwości, często nazywanej nazwą podobną do
IsFirstRun.
Należy pamiętać, że aby nowsza wersja mogła migrować ustawienia aplikacji, musi być również w stanie załadować i odczytać starszą wersję ustawień aplikacji. W związku z tym musi zawierać klasy otoki zgodne zarówno z nowymi, jak i poprzednimi wersjami aplikacji.
