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