Sdílet prostřednictvím


IApplicationSettingsProvider.Upgrade Metoda

Definice

Označuje zprostředkovateli, že aplikace byla upgradována. To poskytovateli nabízí příležitost podle potřeby upgradovat svá uložená nastavení.

public:
 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
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.

Poznámky

Rozhraní .NET Framework umožňuje souběžnou instalaci a spouštění různých verzí stejné aplikace. Zprostředkovatel nastavení aplikace ukládá nastavení aplikace pro každou verzi aplikace samostatně, aby byla zajištěna izolace. Můžete ale chtít migrovat nastavení z předchozí verze aplikace na aktuální verzi. K zajištění této funkce migrace použijte metodu Upgrade implementovanou ve třídě odvozené z SettingsProvider.

Metodu Upgrade můžete použít ve spojení s metodou GetPreviousVersion k migraci nastavení aplikace během instalace nové verze aplikace nebo po této instalaci.

Tato metoda by měla být potlačena pro každé nastavení aplikace, které má NoSettingsVersionUpgradeAttribute použitý objekt , nebo pro celou třídu obálky nastavení odvozenou z ApplicationSettingsBase.

Platí pro

Viz také