LocalFileSettingsProvider.Upgrade Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

LocalFileSettingsProvider.cs

Pokusí se migrovat předchozí nastavení oboru uživatele z předchozí verze stejné aplikace.

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

Popis SettingsContext aktuálního využití aplikace.

properties

SettingsPropertyCollection

Obsahující SettingsPropertyCollection skupinu vlastností nastavení, jejíž hodnoty se mají načíst.

Implementuje

Upgrade(SettingsContext, SettingsPropertyCollection)

Výjimky

ConfigurationErrorsException

Bylo zjištěno nastavení s oborem uživatele, ale aktuální konfigurace podporuje pouze nastavení s oborem aplikace.

-nebo-

Předchozí verze konfiguračního souboru nebyla přístupná.

Poznámky

LocalFileSettingsProvider migruje místní nastavení a nastavení roamingu v samostatných operacích.

Metoda Upgrade je potlačena pro každé nastavení aplikace, které má použito, NoSettingsVersionUpgradeAttribute nebo pro celou třídu obálky nastavení odvozenou z ApplicationSettingsBase.

Tímto způsobem je volána tato metoda závisí na typu upgradované aplikace:

• Každá verze aplikace ClickOnce je uložena ve vlastním izolovaném instalačním adresáři. Po instalaci nové verze aplikace ClickOnce a při prvním spuštění nové verze se automaticky zavolá Upgrade interní logika, která migruje všechna běžná nastavení aplikace do nové verze. Další informace najdete v tématu ClickOnce a Nastavení aplikace.

• Standardní model Windows Forms a konzolové aplikace musí ručně volat Upgrade, protože neexistuje obecný automatický způsob, jak určit, kdy je taková aplikace poprvé spuštěna. Dva běžné způsoby, jak to udělat, jsou buď z instalačního programu, nebo použití ze samotné aplikace, pomocí trvalé vlastnosti, která se často nazývá něco jako IsFirstRun.

Upozorňujeme, že aby novější verze mohla migrovat nastavení aplikace, musí být schopná také načíst a přečíst starší verzi nastavení aplikace. Proto musí obsahovat třídy obálky kompatibilní s novou i předchozí verzí aplikace.

Viz také

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute