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 -> unitPublic Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)Параметры
- context
- SettingsContext
Объект SettingsContext, описывающий текущее использование приложения.
- properties
- SettingsPropertyCollection
Объект SettingsPropertyCollection, содержащий группу свойств параметров, значения которых необходимо извлечь.
Комментарии
Платформа .NET Framework позволяет параллельно устанавливать и выполнять разные версии одного приложения. Поставщик параметров приложения хранит параметры приложения для каждой версии приложения отдельно, чтобы обеспечить изоляцию. Однако может потребоваться перенести параметры из предыдущей версии приложения в текущую. Чтобы предоставить эту функцию миграции, используйте Upgrade метод, реализованный в классе, производном от SettingsProvider.
Этот метод можно использовать Upgrade вместе с методом GetPreviousVersion для переноса параметров приложения во время или после установки новой версии приложения.
Этот метод следует отключить для каждого параметра приложения, к NoSettingsVersionUpgradeAttribute которому применяется этот параметр, или ко всему классу оболочки параметров, производного от ApplicationSettingsBase.