IApplicationSettingsProvider.Upgrade Метод

Определение

Указывает поставщику, что приложение было модернизировано. Это дает поставщику возможность обновлять хранимые параметры подходящим образом.

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)

Параметры

context
SettingsContext

Объект SettingsContext, описывающий текущее использование приложения.

properties
SettingsPropertyCollection

Объект SettingsPropertyCollection, содержащий группу свойств параметров, значения которых необходимо извлечь.

Комментарии

Платформа .NET Framework обеспечивает параллельную установку и выполнение различных версий одного приложения. Поставщик параметров приложения хранит параметры приложения для каждой версии приложения отдельно, чтобы обеспечить изоляцию. Однако может потребоваться перенести параметры из предыдущей версии приложения в текущую. Чтобы предоставить эту функциональность миграции, используйте Upgrade метод , реализованный в классе, производном от SettingsProvider.

Вы можете использовать метод в сочетании Upgrade с методом GetPreviousVersion для переноса параметров приложения во время или после установки новой версии приложения.

Этот метод следует подавлять для каждого параметра приложения, к NoSettingsVersionUpgradeAttribute которому применяется объект , или ко всему классу-оболочке параметров, производного от ApplicationSettingsBase.

Применяется к

См. также раздел