IApplicationSettingsProvider.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í.
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 -> unitPublic 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.
