Udostępnij za pośrednictwem


LocalFileSettingsProvider.Upgrade Metoda

Definicja

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 -> unit
Public 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.

Dotyczy

Zobacz też