Схема параметров приложения

Статья
11/16/2008

Обновлен: Ноябрь 2007

Параметры приложений позволяют приложению Windows Forms или ASP.NET сохранять и вызывать параметры области определения приложения и параметры области пользователя. "Параметр" в данном контексте – это любая информация, относящаяся к приложению или к текущему пользователю, от строки подключения к базе данных до размера окна, предпочитаемого пользователем.

По умолчанию параметры приложения в приложении Windows Forms используют класс LocalFileSettingsProvider, использующий систему конфигурации .NET для хранения параметров в XML-файлах конфигурации. Дополнительные сведения о файлах, используемых параметрами приложения, см. в разделе Архитектура параметров приложения.

Параметры приложения определяют следующие элементы как часть файлов конфигурации.

Элемент	Описание
Элемент <applicationSettings>	Содержит все теги <setting>, относящиеся к приложению.
Элемент <userSettings>	Содержит все теги <setting>, относящиеся к текущему пользователю.
Элемент <setting>	Определяет параметр. Является дочерним для элемента <applicationSettings> или <userSettings>.
Элемент <value>	Определяет значение параметра. Является дочерним для элемента <setting>.

Элемент <applicationSettings>

Этот элемент содержит все теги <setting>, относящиеся к экземпляру приложения на клиентском компьютере. Не содержит атрибуты.

Элемент <userSettings>

Этот элемент содержит все теги <setting>, относящиеся к пользователю, работающему с приложением. Не содержит атрибуты.

Элемент <setting>

Этот элемент определяет параметр. Он имеет следующие атрибуты.

Элемент	Описание
name	Обязательный. Уникальный идентификатор параметра. Параметры, созданные Visual Studio, сохраняются с именем ProjectName.Properties.Settings.
serializedAs	Обязательный. Формат, используемый для сериализации в текстовое представление. Допустимые значения: string. Значение сериализуется в виде строки с помощью класса TypeConverter. xml. Значение сериализуется с использованием сериализации XML. binary. Значение сериализуется с использованием двоичной сериализации. custom. Поставщик параметров имеет встроенные сведения об этом параметре для проведения сериализации и десериализации. При использовании двоичной и пользовательской сериализации необходимо определить собственный класс параметров и использовать класс SettingsSerializeAsAttribute для задания двоичной или пользовательской сериализации.

name

Обязательный. Уникальный идентификатор параметра. Параметры, созданные Visual Studio, сохраняются с именем ProjectName.Properties.Settings.

serializedAs

Обязательный. Формат, используемый для сериализации в текстовое представление. Допустимые значения:

string. Значение сериализуется в виде строки с помощью класса TypeConverter.
xml. Значение сериализуется с использованием сериализации XML.
binary. Значение сериализуется с использованием двоичной сериализации.
custom. Поставщик параметров имеет встроенные сведения об этом параметре для проведения сериализации и десериализации.
При использовании двоичной и пользовательской сериализации необходимо определить собственный класс параметров и использовать класс SettingsSerializeAsAttribute для задания двоичной или пользовательской сериализации.

<value> Element

Этот элемент содержит значение параметра.

Пример

В следующем примере кода показан файл параметров приложения, определяющий два параметра области определения приложения и два параметра области пользователя.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
        </sectionGroup>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />
        </sectionGroup>
    </configSections>
    <applicationSettings>
        <WindowsApplication1.Properties.Settings>
            <setting name="Cursor" serializeAs="String">
                <value>Default</value>
            </setting>
            <setting name="DoubleBuffering" serializeAs="String">
                <value>False</value>
            </setting>
        </WindowsApplication1.Properties.Settings>
    </applicationSettings>
    <userSettings>
        <WindowsApplication1.Properties.Settings>
            <setting name="FormTitle" serializeAs="String">
                <value>Form1</value>
            </setting>
            <setting name="FormSize" serializeAs="String">
                <value>595, 536</value>
            </setting>
        </WindowsApplication1.Properties.Settings>
    </userSettings>
</configuration>

См. также

Основные понятия

Общие сведения о параметрах приложений

Архитектура параметров приложения

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