IApplicationSettingsProvider.Upgrade(SettingsContext, SettingsPropertyCollection) Metoda

Definicja

Wskazuje dostawcy, że aplikacja została uaktualniona.Indicates to the provider that the application has been upgraded. Dzięki temu dostawca może uaktualnić przechowywane ustawienia zgodnie z potrzebami.This offers the provider an opportunity to upgrade its stored settings as appropriate.

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 -> unit
Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

Parametry

context
SettingsContext

SettingsContextOpisującą bieżące użycie aplikacji.A SettingsContext describing the current application usage.

properties
SettingsPropertyCollection

A SettingsPropertyCollection zawierająca grupy właściwości ustawienia, których wartości mają być pobierane.A SettingsPropertyCollection containing the settings property group whose values are to be retrieved.

Uwagi

.NET Framework umożliwia instalację równoległą i wykonywanie różnych wersji tej samej aplikacji.The .NET Framework enables side-by-side installation and execution of different versions of the same application. Dostawca ustawień aplikacji przechowuje ustawienia aplikacji osobno dla każdej wersji aplikacji, aby zapewnić izolację.The application settings provider stores the application settings for each version of an application separately to ensure isolation. Można jednak przeprowadzić migrację ustawień z poprzedniej wersji aplikacji do istniejącej.However, you may want to migrate settings from the previous version of an application to the current one. Aby zapewnić tę funkcjonalność migracji, należy użyć Upgrade metody zaimplementowane w klasie pochodnej z SettingsProvider .To provide this migration functionality, use the Upgrade method, implemented in a class derived from SettingsProvider.

Metody można użyć Upgrade w połączeniu z GetPreviousVersion metodą migracji ustawień aplikacji podczas instalacji nowej wersji aplikacji lub po jej zakończeniu.You can use the Upgrade method in conjunction with the GetPreviousVersion method to migrate application settings during or after the installation of a new version of an application.

Ta metoda powinna być pomijana dla każdego ustawienia aplikacji, do którego NoSettingsVersionUpgradeAttribute zastosowano ten element, lub do całej klasy otoki ustawień pochodnej od ApplicationSettingsBase .This method should be suppressed for every application setting that has the NoSettingsVersionUpgradeAttribute is applied to it, or to the entire settings wrapper class, derived from ApplicationSettingsBase.

Dotyczy

Zobacz też