IApplicationSettingsProvider.Upgrade Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geeft aan de provider aan dat de toepassing is bijgewerkt. Dit biedt de provider de mogelijkheid om de opgeslagen instellingen naar wens te upgraden.
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)Parameters
- context
- SettingsContext
Een SettingsContext beschrijving van het huidige toepassingsgebruik.
- properties
- SettingsPropertyCollection
Een SettingsPropertyCollection met de groep instellingeneigenschappen waarvan de waarden moeten worden opgehaald.
Opmerkingen
.NET Framework maakt de installatie en uitvoering van verschillende versies van dezelfde toepassing naast elkaar mogelijk. De provider van toepassingsinstellingen slaat de toepassingsinstellingen voor elke versie van een toepassing afzonderlijk op om isolatie te garanderen. Mogelijk wilt u echter instellingen migreren van de vorige versie van een toepassing naar de huidige. Als u deze migratiefunctionaliteit wilt bieden, gebruikt u de Upgrade methode die is geïmplementeerd in een klasse die is afgeleid van SettingsProvider.
U kunt de Upgrade methode gebruiken in combinatie met de GetPreviousVersion methode om toepassingsinstellingen te migreren tijdens of na de installatie van een nieuwe versie van een toepassing.
Deze methode moet worden onderdrukt voor elke toepassingsinstelling waarop de NoSettingsVersionUpgradeAttribute toepassing is toegepast, of voor de hele wrapperklasse voor instellingen, afgeleid van ApplicationSettingsBase.