IApplicationSettingsProvider.Upgrade Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger för providern att programmet har uppgraderats. Detta ger leverantören möjlighet att uppgradera sina lagrade inställningar efter behov.
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)Parametrar
- context
- SettingsContext
En SettingsContext som beskriver den aktuella programanvändningen.
- properties
- SettingsPropertyCollection
En SettingsPropertyCollection som innehåller egenskapsgruppen för inställningar vars värden ska hämtas.
Kommentarer
.NET Framework möjliggör installation och körning sida vid sida av olika versioner av samma program. Programinställningsprovidern lagrar programinställningarna för varje version av ett program separat för att säkerställa isolering. Du kanske dock vill migrera inställningar från den tidigare versionen av ett program till den aktuella. Om du vill tillhandahålla den här migreringsfunktionen använder du Upgrade metoden som implementeras i en klass som härleds från SettingsProvider.
Du kan använda Upgrade metoden tillsammans med GetPreviousVersion metoden för att migrera programinställningar under eller efter installationen av en ny version av ett program.
Den här metoden bör ignoreras för varje programinställning som har NoSettingsVersionUpgradeAttribute tillämpats på den, eller för hela inställningsomslutningsklassen som härletts från ApplicationSettingsBase.