LocalFileSettingsProvider.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.
Hiermee probeert u eerdere instellingen met gebruikersbereik te migreren van een eerdere versie van dezelfde toepassing.
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 -> 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.
Implementeringen
Uitzonderingen
Er is een instelling met gebruikersbereik aangetroffen, maar de huidige configuratie ondersteunt alleen instellingen voor toepassingsbereik.
– of –
De vorige versie van het configuratiebestand kan niet worden geopend.
Opmerkingen
LocalFileSettingsProvider migreert de lokale en roaminginstellingen in afzonderlijke bewerkingen.
De Upgrade methode wordt onderdrukt voor elke toepassingsinstelling waarop de NoSettingsVersionUpgradeAttribute toepassing is toegepast, of voor de hele wrapperklasse voor instellingen, afgeleid van ApplicationSettingsBase.
Deze methode wordt op deze manier aangeroepen, is afhankelijk van het type toepassing dat wordt bijgewerkt:
Elke versie van een ClickOnce-toepassing wordt opgeslagen in een eigen geïsoleerde installatiemap. Nadat een nieuwe versie van een ClickOnce-toepassing is geïnstalleerd en wanneer de nieuwe versie voor het eerst wordt uitgevoerd, wordt interne logica automatisch aangeroepen Upgrade om alle algemene toepassingsinstellingen naar de nieuwe versie te migreren. Zie ClickOnce and Application Settingsvoor meer informatie.
Standaard-Windows Forms- en consoletoepassingen moeten handmatig Upgrade aanroepen, omdat er geen algemene, automatische manier is om te bepalen wanneer een dergelijke toepassing voor het eerst wordt uitgevoerd. De twee gebruikelijke manieren om dit te doen, zijn afkomstig uit het installatieprogramma of het gebruik van de toepassing zelf, met behulp van een persistente eigenschap, vaak een naam zoals
IsFirstRun.
Houd er rekening mee dat voor de nieuwere versie voor het migreren van toepassingsinstellingen ook de oudere versie van de toepassingsinstellingen moet kunnen worden geladen en gelezen. Daarom moet deze wrapperklassen bevatten die compatibel zijn met zowel de nieuwe als eerdere versies van de toepassing.