ApplicationSettingsBase.Upgrade Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Aktualizace nastavení aplikace tak, aby odrážela novější instalaci aplikace.
public:
virtual void Upgrade();
public virtual void Upgrade ();
abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit
Public Overridable Sub Upgrade ()
Výjimky
Konfigurační soubor nelze analyzovat.
Poznámky
Metoda Upgrade provede dvě akce, které zajistí hladký přechod na novou verzi aplikace:
Informuje všechny odpovídající poskytovatele nastavení o existenci upgradované aplikace prostřednictvím volání jejich IApplicationSettingsProvider.Upgrade metody za předpokladu, že implementovali IApplicationSettingsProvider rozhraní. Tato akce se neprovádí, pokud je třída obálky nastavení označená pomocí NoSettingsVersionUpgradeAttribute.
Znovu načte hodnoty pro všechna nastavení aplikace.
Výchozí chování Upgrade můžete přepsat a implementovat vlastní chování při upgradu nebo slučování. Použijte metodu GetPreviousVersion k načtení jednotlivých hodnot pro nastavení pro předchozí verzi aplikace. Příklady vlastního chování při upgradu:
Použití nových výchozích hodnot zásad, které přepíší jednu nebo více předchozích hodnot zadaných uživatelem nebo předchozích výchozích hodnot.
Speciální překlad starých hodnot pro kompatibilitu s novějšími rozsahy, jinou skupinou vlastností nastavení atd.