ApplicationSettingsBase.Upgrade Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ApplicationSettingsBase.cs

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 -> unit

Public Overridable Sub Upgrade ()

Ausnahmen

ConfigurationErrorsException

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.

Weitere Informationen

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)