Поделиться через


LocalFileSettingsProvider.Upgrade Метод

Определение

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

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, содержащий группу свойств параметров, значения которых необходимо извлечь.

Реализации

Исключения

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

-или-

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

Комментарии

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

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

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

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

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

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

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

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