LocalFileSettingsProvider.Upgrade Methode

Referenz

Definition

Namespace:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.dll

Paket:: System.Configuration.ConfigurationManager v6.0.0

Paket:: System.Configuration.ConfigurationManager v7.0.0

Paket:: System.Configuration.ConfigurationManager v8.0.0

Paket:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Quelle:: LocalFileSettingsProvider.cs

Quelle:: LocalFileSettingsProvider.cs

Quelle:: LocalFileSettingsProvider.cs

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

Implementiert

Upgrade(SettingsContext, SettingsPropertyCollection)

Ausnahmen

ConfigurationErrorsException

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.

Gilt für:

Freigeben über