ClickOnce и параметры приложения
Обновлен: Ноябрь 2007
Параметры приложения для Windows Forms облегчают создание, хранение и обслуживание настраиваемого приложения и пользовательских параметров на клиенте. Функционирование файлов параметров приложения в приложении ClickOnce и перенос параметров по технологии ClickOnce, когда пользователь обновляет приложение до следующей версии, описывается в следующем документе.
Приводимые ниже сведения применимы только к поставщику параметров приложения по умолчанию, классу LocalFileSettingsProvider. Если предоставляется настраиваемый поставщик, этим поставщиком определяется, как он хранит свои данные и как он обновляет свои параметры при переходе между версиями. Дополнительные сведения о поставщиках параметров приложений см. в разделе Архитектура параметров приложения.
Файлы параметров приложений
Параметры приложения занимают два файла: app.exe.config и user.config, где app — имя приложения Windows Forms. Файл user.config создается на клиенте при первоначальном сохранении приложением параметров, диапазоны которых определяются пользователем. Напротив, файл app.exe.config существует до развертывания, если для параметров определены значения по умолчанию. Среда Visual Studio включает этот файл автоматически при использовании ее команды Publish (Публикация). Если приложение ClickOnce создается с помощью Mage.exe или MageUI.exe, следует убедиться, что этот файл включен с другими файлами приложения, когда заполняется манифест приложения.
В приложениях Windows Forms, не развернутых с помощью ClickOnce, файл app.exe.config для приложения хранится в каталоге приложения, тогда как файл user.config хранится в пользовательской папке Documents and Settings. В приложении ClickOnce файл app.exe.config находится в каталоге приложения внутри кэша приложения ClickOnce, а файл user.config — в каталоге данных ClickOnce для этого приложения.
Независимо от способа развертывания приложения параметры приложения обеспечивают безопасный доступ к файлу app.exe.config с правом на чтение и безопасный доступ к файлу user.config с правами на чтение и запись.
В приложении ClickOnce размер файлов конфигураций, используемых параметрами приложения, ограничивается размером кэша ClickOnce. Дополнительные сведения см. в разделе Общие сведения о кэше ClickOnce.
Обновления версий
Так как каждая версия приложения ClickOnce изолирована от всех остальных версий, параметры приложения ClickOnce так же изолированы от параметров других версий. Когда пользователь обновляет приложение до более поздней версии, выполняется сравнение параметров приложения самой последней (наибольший номер) версии с параметрами, поставляемыми с обновленной версией, и параметры объединяются в новый набор файлов параметров.
Способ определения того, какие параметры должны копироваться, описывается в следующей таблице.
Тип изменения |
Действие обновления |
|---|---|
Параметр, добавляемый в файл app.exe.config |
Новый параметр объединяется в файле app.exe.config текущей версии |
Параметр, удаляемый из файла app.exe.config |
Старый параметр удаляется из файла app.exe.config текущей версии |
Изменилось значение параметра, используемое по умолчанию; локальный параметр в файле user.config по-прежнему равен исходному значению по умолчанию |
Параметр объединяется в файле user.config текущей версии с новым значением по умолчанию в качестве значения |
Изменилось значение параметра, используемое по умолчанию; параметр в файле user.config установлен в значение, отличное от значения по умолчанию |
Параметр объединяется в файле user.config текущей версии с сохраненным значением, отличным от значения по умолчанию |
Если создан свой собственный класс упаковщика параметров приложения и требуется настроить алгоритм обновления, можно переопределить метод Upgrade.
ClickOnce и настройки роуминга
Технология ClickOnce не работает с настройками роуминга, которые позволяют перемещать файл параметров по компьютерам в сети. Если требуются настройки роуминга, следует реализовать поставщика параметров приложения, который хранит параметры в сети, или разработать свои собственные классы параметров, для хранения параметров на удаленно расположенном компьютере. Дополнительные сведений о поставщиках параметров см. в разделе Архитектура параметров приложения.
См. также
Основные понятия
Общие сведения о параметрах приложений
Общие сведения о кэше ClickOnce
Доступ к локальным и удаленным данным в приложениях ClickOnce