ApplicationSettingsBase.Upgrade Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Aktualisiert Anwendungseinstellungen, um eine neuere Installation der Anwendung widerzuspiegeln.
public:
virtual void Upgrade();public virtual void Upgrade();abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unitPublic Overridable Sub Upgrade ()Ausnahmen
Die Konfigurationsdatei konnte nicht analysiert werden.
Hinweise
Die Upgrade Methode führt zwei Aktionen aus, um einen reibungslosen Übergang zu einer neuen Version einer Anwendung zu gewährleisten:
Sie benachrichtigt alle entsprechenden Einstellungsanbieter über einen Aufruf ihrer IApplicationSettingsProvider.Upgrade Methode, vorausgesetzt, sie haben die IApplicationSettingsProvider Schnittstelle implementiert. Diese Aktion wird nicht ausgeführt, wenn die Einstellungswrapperklasse mit NoSettingsVersionUpgradeAttributemarkiert ist.
Sie lädt die Werte für alle Anwendungseinstellungen neu.
Sie können das Standardverhalten außer Kraft setzen, um benutzerdefinierte Aktualisierungs- oder Zusammenführungsverhalten Upgrade zu implementieren. Verwenden Sie die GetPreviousVersion Methode, um einzelne Werte für eine Einstellung für die vorherige Version der Anwendung abzurufen. Beispiele für ein benutzerdefiniertes Upgradeverhalten sind:
Bei Verwendung neuer Richtlinienstandardwerte, die einen oder mehrere der vorherigen vom Benutzer angegebenen Werte oder früheren Standardwerte außer Kraft setzen, wird die Standardeinstellung verwendet.
Spezielle Übersetzung alter Werte, die mit neueren Bereichen, einer anderen Einstellungseigenschaftengruppe usw. kompatibel sind.
