LocalFileSettingsProvider.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.
Versucht, vorherige Einstellungen mit Benutzerbereich aus einer früheren Version derselben Anwendung zu migrieren.
public:
virtual 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
override this.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.
Implementiert
Ausnahmen
Es wurde eine Einstellung mit Benutzerbereich gefunden, die aktuelle Konfiguration unterstützt jedoch nur anwendungsbezogene Einstellungen.
-oder-
Auf die vorherige Version der Konfigurationsdatei konnte nicht zugegriffen werden.
Hinweise
LocalFileSettingsProvider migriert die lokalen und Roamingeinstellungen in separaten Vorgängen.
Die Upgrade Methode wird für jede Anwendungseinstellung unterdrückt, die darauf NoSettingsVersionUpgradeAttribute angewendet wurde, oder für die gesamte Einstellungswrapperklasse, die von ApplicationSettingsBase.
Auf diese Weise wird diese Methode aufgerufen, hängt vom Typ der Anwendung ab, die aktualisiert wird:
Jede Version einer ClickOnce-Anwendung wird in einem eigenen isolierten Installationsverzeichnis gespeichert. Nachdem eine neue Version einer ClickOnce-Anwendung installiert wurde und die neue Version zum ersten Mal ausgeführt wird, ruft Upgrade die interne Logik automatisch auf, um alle allgemeinen Anwendungseinstellungen in die neue Version zu migrieren. Weitere Informationen finden Sie unter ClickOnce und Anwendungseinstellungen.
Standard-Windows Forms- und Konsolenanwendungen müssen manuell Upgrade aufrufen, da es keine allgemeine, automatische Möglichkeit gibt, zu bestimmen, wann eine solche Anwendung zum ersten Mal ausgeführt wird. Die beiden gängigen Methoden hierfür stammen entweder aus dem Installationsprogramm oder der Verwendung aus der Anwendung selbst, wobei eine beibehaltene Eigenschaft verwendet wird, die häufig wie folgt
IsFirstRunbenannt wird.
Beachten Sie, dass für die neuere Version zum Migrieren von Anwendungseinstellungen auch die ältere Version der Anwendungseinstellungen geladen und gelesen werden muss. Daher muss sie Wrapperklassen enthalten, die sowohl mit den neuen als auch mit früheren Versionen der Anwendung kompatibel sind.