ApplicationSettingsBase.Upgrade Метод

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

ApplicationSettingsBase.cs

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

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

Исключения

ConfigurationErrorsException

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

Комментарии

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

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

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

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

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

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

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

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)