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 aktuellere Installation der Anwendung wiederzugeben.
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 sicherzustellen:
Es benachrichtigt alle entsprechenden Einstellungsanbieter über das Vorhandensein der aktualisierten Anwendung durch einen Aufruf ihrer IApplicationSettingsProvider.Upgrade -Methode, vorausgesetzt, sie haben die IApplicationSettingsProvider Schnittstelle implementiert. Diese Aktion wird nicht ausgeführt, wenn die Einstellungswrapperklasse mit NoSettingsVersionUpgradeAttributegekennzeichnet ist.
Die Werte für alle Anwendungseinstellungen werden neu geladen.
Sie können das Standardverhalten von Upgrade überschreiben, um benutzerdefiniertes Upgrade- oder Zusammenführungsverhalten 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 benutzerdefiniertes Upgradeverhalten sind:
Die Verwendung neuer Richtlinienstandardwerte, die einen oder mehrere der vorherigen benutzerdefinierten Werte oder vorherigen Standardwerte außer Kraft setzen.
Spezielle Übersetzung alter Werte, um mit neueren Bereichen, einer anderen Einstellungseigenschaftengruppe usw. kompatibel zu sein.
