ApplicationSettingsBase.Upgrade Metoda

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ApplicationSettingsBase.cs

Aktualizacje ustawienia aplikacji, aby odzwierciedlić najnowszą instalację aplikacji.

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

Wyjątki

ConfigurationErrorsException

Nie można przeanalizować pliku konfiguracji.

Uwagi

Metoda Upgrade wykonuje dwie akcje, aby zapewnić płynne przejście do nowej wersji aplikacji:

• Powiadamia wszystkich odpowiednich dostawców ustawień o istnieniu uaktualnionej aplikacji za pomocą wywołania metody IApplicationSettingsProvider.Upgrade , zakładając, że zaimplementowali IApplicationSettingsProvider interfejs. Ta akcja nie jest wykonywana, jeśli klasa otoki ustawień jest oznaczona za pomocą polecenia NoSettingsVersionUpgradeAttribute.

• Ponownie ładuje wartości dla wszystkich ustawień aplikacji.

Domyślne zachowanie można zastąpić w celu zaimplementowania niestandardowego Upgrade zachowania uaktualniania lub scalania. GetPreviousVersion Użyj metody , aby pobrać poszczególne wartości dla ustawienia dla poprzedniej wersji aplikacji. Przykłady niestandardowego zachowania uaktualniania obejmują:

• Użycie nowych ustawień domyślnych zasad, które zastępują co najmniej jedną z poprzednich wartości określonych przez użytkownika lub poprzednich wartości domyślnych.

• Specjalne tłumaczenie starych wartości, które mają być zgodne z nowszymi zakresami, inną grupą właściwości ustawień itd.

Zobacz też

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)