IApplicationSettingsProvider.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.
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 -> unitPublic 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.
