Общие сведения о параметрах приложений
В этой статье описывается создание и хранение данных параметров от имени приложения и пользователей.
Параметры приложения в Windows Forms позволяют легко создавать, хранить и поддерживать настраиваемые приложения и параметры пользователей на клиентском компьютере. С помощью параметров приложения Windows Forms можно хранить не только данные приложения, например строки подключений к базам данных, но и пользовательские данные, такие как предпочтения пользователя приложения. Используя Visual Studio или настраиваемый управляемый код, можно создавать новые параметры, читать их и записывать на диск, связывать их со свойствами в формах и проверять данные параметров до загрузки и сохранения.
Параметры приложения позволяют разработчикам сохранять состояние приложений с помощью компактного по объему пользовательского кода. Они являются заменой динамических свойств из предыдущих версий .NET Framework. Параметры приложения содержат много улучшений по сравнению с динамическими свойствами, которые доступны только для чтения. Кроме того, в динамических свойствах используется позднее связывание, и для них требуется дополнительное программирование. Классы динамических свойств были сохранены на платформе .NET Framework 2.0, но они являются лишь классами-оболочками для классов параметров приложения.
Что такое параметры приложения
Приложениям Windows Forms часто требуются важные для их выполнения данные, которые, однако, нежелательно включать непосредственно в код приложения. Если приложение использует веб-службу или сервер базы данных, эти сведения можно хранить в отдельном файле, чтобы в будущем была возможность изменить их без перекомпиляции. Аналогичным образом приложению может потребоваться сохранить данные, относящиеся к текущему пользователю. В большинстве приложений, например, применяются пользовательские предпочтения, определяющие внешний вид и поведение приложения.
Параметры приложения отвечают обеим потребностям, предоставляя простой способ хранения параметров приложения и пользователей на клиентском компьютере. С помощью Visual Studio или редактора кода можно определить значение параметра, указав его имя, тип данных и область действия (приложение или пользователь). Вы можете даже поместить связанные параметры в именованные группы для повышения простоты и удобочитаемости кода. После определения эти параметры сохраняются и считываются обратно в память автоматически во время выполнения. Подключаемая архитектура позволяет изменять механизм сохранения, однако по умолчанию используется локальная файловая система.
Параметры приложения работают путем сохранения данных в формате XML в различных файлах конфигурации (CONFIG-файлах) в зависимости от того, что является областью действия параметра — приложение или пользователь. В большинстве случаев параметры приложения доступны только для чтения. Так как они содержат сведения для программы, обычно их не нужно перезаписывать. Параметры пользователей, напротив, можно и считывать, и записывать во время выполнения, даже если приложение работает в режиме частичного доверия. Дополнительные сведения о частичном доверии см. в разделе Security in Windows Forms Overview.
Параметры хранятся в виде XML-фрагментов в файлах конфигурации. Параметры приложения представлены элементом <applicationSettings>
. Обычно они размещаются в файле app.exe.config, где app — имя основного исполняемого файла. Параметры, область пользователей, представлены элементом <userSettings>
и помещаются в user.config. Необходимо развернуть файл app.exe.config с приложением. Архитектура параметров создаст файл user.config по запросу при первом сохранении параметров для этого пользователя. Вы можете также определить блок <userSettings>
в файле app.exe.config, чтобы предоставить значения по умолчанию для параметров пользователя.
Пользовательские элементы управления могут сохранять собственные параметры с помощью реализации интерфейса IPersistComponentSettings , который предоставляет метод SaveSettings . Элемент управления ToolStrip Windows Forms реализует этот интерфейс, чтобы сохранить положение панелей инструментов и их элементов между сеансами приложения. Дополнительные сведения о пользовательских элементах управления и параметрах приложения см. в разделе Application Settings for Custom Controls.
Где хранятся параметры область пользователя
Поставщик LocalFileSettingsProviderпо умолчанию сохраняет параметры область пользователя в папкеLocalApplicationData. Если эта папка недоступна, ApplicationData используется папка. Вложенная папка для конкретного приложения создается для хранения файла параметров область пользователя. Имя этой папки основано на трех атрибутах основной сборки приложения:
- Сборка CompanyName.
- Хэшированного значения на основе двух частей информации:
- Сборка FriendlyName. Если
FriendlyName
он недоступен, ProductName используется. - Если сборка StrongName доступна, в противном случае используется абсолютный путь к папке сборки.
- Сборка FriendlyName. Если
- Строка AssemblyName.Version .
Если какие-либо из предыдущих сведений о сборке изменяются, предыдущие параметры область пользователя теряются, так как создается новое имя вложенной папки. Например, если выпущена новая версия приложения и AssemblyName.Version
значение отличается от предыдущей версии, имя вложенной папки, используемой для хранения изменений параметров область пользователя. Если параметры пользователя должны сохраняться между выпусками приложений, создайте настраиваемый поставщик параметров. Дополнительные сведения см. в разделе "Пользовательские поставщики Параметры".
Ограничения параметров приложения
Нельзя использовать параметры приложения в неуправляемых приложениях, которые размещаются в среде .NET Framework. Параметры не будут работать в таких средах, как надстройки Visual Studio, C++ для Microsoft Office, элементы управления, размещенные в Internet Explorer, или надстройки и проекты Microsoft Outlook.
В настоящее время нельзя выполнить привязку к некоторым свойствам в Windows Forms. Наиболее важным примером является свойство ClientSize , так как привязка к этому свойству вызовет непредсказуемое поведение во время выполнения. Как правило, такого рода проблем можно избежать путем программного сохранения и загрузки этих параметров.
Параметры приложения не имеют встроенных средств для автоматического шифрования информации. Никогда не следует хранить конфиденциальные данные, такие как пароли к базам данных, в виде открытого текста. Если требуется хранить такие сведения, то разработчик приложения обязан обеспечить надлежащую безопасность хранения. Если нужно хранить строки подключений, рекомендуется использовать встроенную систему безопасности Windows и не прибегать к таким средствам, как жесткое программирование паролей в URL-адресах. Для получения дополнительной информации см. Code Access Security and ADO.NET.
Начало работы с параметрами приложения
Если используется Visual Studio, вы можете определить параметры в конструкторе Windows Forms с помощью свойства (ApplicationSettings) в окне Свойства . При таком определении параметров Visual Studio автоматически создает пользовательский управляемый класс-оболочку, связывающий каждый параметр со свойством класса. Visual Studio также обеспечивает привязку параметра к свойству в форме или элементе управления таким образом, чтобы параметры элемента управления автоматически восстанавливались при отображении содержащей его формы и автоматически сохранялись при закрытии формы.
Если требуется более детальное управление параметрами, можно определить собственный класс-оболочку параметров приложения. Для этого нужно создать класс, производный от ApplicationSettingsBase, добавить свойства, соответствующие каждому параметру, и применить к ним специальные атрибуты. Дополнительные сведения о создании классов-оболочек см. в разделе Application Settings Architecture.
Вы можете также использовать класс Binding для программной привязки параметров к свойствам в формах и элементах управления.
См. также
- ApplicationSettingsBase
- SettingsProvider
- LocalFileSettingsProvider
- IPersistComponentSettings
- Практическое руководство. Проверка параметров приложения
- Управление параметрами приложения (.NET)
- Практическое руководство. Считывание параметров во время выполнения с помощью C#
- Использование параметров приложения и параметров пользователя
- Архитектура параметров приложения
- Application Settings for Custom Controls
.NET Desktop feedback