LocalFileSettingsProvider.Upgrade Метод

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

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

LocalFileSettingsProvider.cs

Выполняет попытку переместить предыдущие параметры на уровне пользователя из предыдущих версий того же приложения.

public:
 virtual 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
override this.Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit

Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

Параметры

context

SettingsContext

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

properties

SettingsPropertyCollection

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

Реализации

Upgrade(SettingsContext, SettingsPropertyCollection)

Исключения

ConfigurationErrorsException

Был обнаружен параметр на уровне пользователя, но текущая конфигурация поддерживает только параметры на уровне приложения.

-или-

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

Комментарии

LocalFileSettingsProvider переносит локальные и перемещаемые параметры в отдельных операциях.

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

Таким образом, этот метод вызывается в зависимости от типа обновляемого приложения:

• Каждая версия приложения ClickOnce хранится в отдельном изолированном каталоге установки. После установки новой версии приложения ClickOnce и при первом запуске новой версии внутренняя логика автоматически вызывает Upgrade для переноса всех общих параметров приложения в новую версию. Дополнительные сведения см. в разделе ClickOnce и параметры приложения.

• Стандартные Windows Forms и консольные приложения должны вручную вызывать Upgrade, так как не существует общего автоматического способа определения времени первого запуска такого приложения. Это можно сделать двумя распространенными способами: из программы установки или с помощью из самого приложения, используя сохраненное свойство, которое часто называется чем-то вроде IsFirstRun.

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

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

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute