ApplicationSettingsBase.Upgrade Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

ApplicationSettingsBase.cs

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

ConfigurationErrorsException

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.

Viz také

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