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, frühere, den Benutzer betreffende Einstellungen 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
Ein SettingsContext, der die aktuelle Anwendungsverwendung beschreibt.
- properties
- SettingsPropertyCollection
Eine SettingsPropertyCollection, die die Einstellungseigenschaftengruppe enthält, deren Werte abgerufen werden sollen.
Implementiert
Ausnahmen
Eine die Benutzer betreffende Einstellung wurde gefunden, die aktuelle Konfiguration unterstützt aber nur die Anwendung betreffende Einstellungen.
- oder -
Auf die vorherige Version der Konfigurationsdatei konnte nicht zugegriffen werden.
Hinweise
LocalFileSettingsProvider migriert die lokalen Einstellungen und die Roamingeinstellungen in separaten Vorgängen.
Die Upgrade -Methode wird für jede Anwendungseinstellung unterdrückt, die auf sie NoSettingsVersionUpgradeAttribute angewendet wird, oder für die gesamte Einstellungs-Wrapperklasse, die von ApplicationSettingsBaseabgeleitet wird.
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 die interne Logik automatisch auf Upgrade , um alle gängigen Anwendungseinstellungen zur neuen Version zu migrieren. Weitere Informationen finden Sie unter ClickOnce und Anwendungseinstellungen.
Standard- Windows Forms- und Konsolenanwendungen müssen manuell aufrufenUpgrade, da es keine allgemeine, automatische Möglichkeit gibt, zu bestimmen, wann eine solche Anwendung zum ersten Mal ausgeführt wird. Die beiden gängigen Möglichkeiten hierfür sind entweder das Installationsprogramm oder die Verwendung von der Anwendung selbst, wobei eine persistente Eigenschaft verwendet wird, die häufig etwa genannt
IsFirstRunwird.
Beachten Sie, dass die neuere Version zum Migrieren von Anwendungseinstellungen auch in der Lage sein muss, die ältere Version der Anwendungseinstellungen zu laden und zu lesen. Daher muss sie Wrapperklassen enthalten, die sowohl mit der neuen als auch mit früheren Versionen der Anwendung kompatibel sind.
