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.
