Freigeben über


LocalFileSettingsProvider.Upgrade Methode

Definition

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

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.

Gilt für:

Weitere Informationen