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 an, dass der Anbieter, für den die Anwendung aktualisiert wurde. Dies bietet dem Anbieter die Möglichkeit, die 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
Eine SettingsContext Beschreibung der aktuellen Anwendungsverwendung.
- properties
- SettingsPropertyCollection
A SettingsPropertyCollection containing the settings property group whose values are to be retrieved.
Hinweise
Das .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 Isolierung sicherzustellen. Möglicherweise möchten Sie jedoch Einstellungen aus der vorherigen Version einer Anwendung zum aktuellen migrieren. Um diese Migrationsfunktionalität bereitzustellen, verwenden Sie die Methode, die Upgrade in einer von der Klasse abgeleiteten Klasse implementiert wird SettingsProvider.
Sie können die Methode zusammen mit der UpgradeGetPreviousVersion 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 die NoSettingsVersionUpgradeAttribute Anwendung angewendet wurde, oder für die gesamte Einstellungswrapperklasse, die von ApplicationSettingsBase.
