IApplicationSettingsProvider.Upgrade Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

IApplicationSettingsProvider.cs

Gibt dem Anbieter an, dass die Anwendung aktualisiert wurde. Dadurch erhält der Anbieter die Gelegenheit, seine gespeicherten Einstellungen entsprechend zu aktualisieren.

public:
 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

Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

Parameter

context

SettingsContext

Ein SettingsContext, der die aktuelle Anwendungsverwendung beschreibt.

properties

SettingsPropertyCollection

Eine SettingsPropertyCollection, die die Einstellungseigenschaftengruppe enthält, deren Werte abgerufen werden sollen.

Hinweise

Die .NET Framework ermöglicht die parallele Installation und Ausführung verschiedener Versionen derselben Anwendung. Der Anwendungseinstellungsanbieter speichert die Anwendungseinstellungen für jede Version einer Anwendung separat, um die Isolation sicherzustellen. Möglicherweise möchten Sie jedoch Einstellungen von der vorherigen Version einer Anwendung zur aktuellen version migrieren. Verwenden Sie zum Bereitstellen dieser Migrationsfunktion die -Methode, die Upgrade in einer von SettingsProviderabgeleiteten Klasse implementiert ist.

Sie können die Upgrade -Methode in Verbindung mit der GetPreviousVersion -Methode verwenden, um Anwendungseinstellungen während oder nach der Installation einer neuen Version einer Anwendung zu migrieren.

Diese Methode sollte für jede Anwendungseinstellung unterdrückt werden, auf die angewendet NoSettingsVersionUpgradeAttribute wird, oder für die gesamte Einstellungs-Wrapperklasse, die von ApplicationSettingsBaseabgeleitet wird.

Weitere Informationen

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• Parallele Ausführung