ApplicationSettingsBase.Upgrade Метод

Определение

Обновляет параметры приложения в соответствии с последней установкой приложения.

public:
 virtual void Upgrade();
public virtual void Upgrade ();
abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit
Public Overridable Sub Upgrade ()

Исключения

Не удалось проанализировать файл конфигурации.

Комментарии

Метод Upgrade выполняет два действия для обеспечения плавного перехода на новую версию приложения:

  • Он уведомляет всех соответствующих поставщиков параметров о существовании обновленного приложения с помощью вызова метода IApplicationSettingsProvider.Upgrade , при условии, что они реализовали IApplicationSettingsProvider интерфейс . Это действие не выполняется, если класс-оболочка параметров помечен как NoSettingsVersionUpgradeAttribute.

  • Он перезагружает значения для всех параметров приложения.

Поведение по умолчанию можно переопределить для реализации пользовательского Upgrade поведения обновления или слияния. Используйте метод для GetPreviousVersion получения отдельных значений параметра для предыдущей версии приложения. Примеры поведения пользовательского обновления:

  • Использование новых значений политики по умолчанию, которые переопределяют одно или несколько предыдущих значений, заданных пользователем, или предыдущих значений по умолчанию.

  • Специальный перевод старых значений для совместимости с новыми диапазонами, другой группой свойств параметров и т. д.

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

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