ApplicationSettingsBase.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 worden toepassingsinstellingen bijgewerkt om een recentere installatie van de toepassing weer te geven.
public:
virtual void Upgrade();
public virtual void Upgrade();
abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit
Public Overridable Sub Upgrade ()
Uitzonderingen
Het configuratiebestand kan niet worden geparseerd.
Opmerkingen
De Upgrade methode voert twee acties uit om een soepele overgang naar een nieuwe versie van een toepassing te garanderen:
Hiermee worden alle bijbehorende instellingenproviders op de hoogte gebracht van het bestaan van de bijgewerkte toepassing via een aanroep naar hun IApplicationSettingsProvider.Upgrade methode, ervan uitgaande dat ze de IApplicationSettingsProvider interface hebben geïmplementeerd. Deze actie wordt niet uitgevoerd als de wrapper-klasse instellingen is gemarkeerd met NoSettingsVersionUpgradeAttribute.
Hiermee worden de waarden voor alle toepassingsinstellingen opnieuw geladen.
U kunt het standaardgedrag van het implementeren van Upgrade aangepaste upgrade- of samenvoegingsgedrag overschrijven. Gebruik de GetPreviousVersion methode om afzonderlijke waarden op te halen voor een instelling voor de vorige versie van de toepassing. Voorbeelden van aangepaste upgradegedrag zijn:
Nieuwe beleidsstandaarden gebruiken die een of meer van de vorige door de gebruiker opgegeven waarden of eerdere standaardwaarden overschrijven.
Speciale vertaling van oude waarden die compatibel zijn met nieuwere bereiken, een andere groep instellingen, enzovoort.