LocalFileSettingsProvider.Upgrade Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Configuration

Zestaw:: System.Configuration.ConfigurationManager.dll

Zestaw:: System.dll

Pakiet:: System.Configuration.ConfigurationManager v6.0.0

Pakiet:: System.Configuration.ConfigurationManager v7.0.0

Pakiet:: System.Configuration.ConfigurationManager v8.0.0

Pakiet:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Źródło:: LocalFileSettingsProvider.cs

Źródło:: LocalFileSettingsProvider.cs

Źródło:: LocalFileSettingsProvider.cs

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 -> 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

Upgrade(SettingsContext, SettingsPropertyCollection)

Wyjątki

ConfigurationErrorsException

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

Share via