Параметры приложения для пользовательских элементов управления

Необходимо выполнить определенные задачи, чтобы предоставить возможность сохранения параметров приложения элементы управления расположены в сторонних приложениях пользовательских элементов управления.

Большая часть документации о параметры приложения записывается в предположении, что вы создаете изолированное приложение. Тем не менее, если вы создаете элемент управления, который будет размещаться другим разработчикам в своих приложениях, необходимо выполнить ряд дополнительных действий для элемента управления для сохранения его параметры должным образом.

Параметры приложения и пользовательские элементы управления

Элемент управления правильно сохранял свои параметры, он должен инкапсулировать процесс, создав свой собственный выделенный приложений параметры оболочки класс, производный от ApplicationSettingsBase. Кроме того, необходимо реализовать класс основной элемент управления IPersistComponentSettings. Интерфейс содержит несколько свойств, а также два метода LoadComponentSettings и SaveComponentSettings. Если добавить элемент управления в форме с помощью конструктор Windows Forms в Visual Studio, Windows Forms будет вызывать LoadComponentSettings автоматически при инициализации элемента управления; необходимо вызвать SaveComponentSettings самостоятельно в Dispose метод вашего элемента управления.

Кроме того чтобы параметры приложения для пользовательских элементов управления для правильной работы в средах разработки, таких как Visual Studio следует реализовать следующие:

  1. Пользовательский класс параметров приложения с помощью конструктора, принимающего IComponent в качестве единственного параметра. Этот класс используется для сохранения и загрузки всех параметров приложения. При создании нового экземпляра этого класса, передайте пользовательский элемент управления с помощью конструктора.

  2. Создайте этот пользовательский класс параметров после создан и помещен в форму, например в форме элемент управления Load обработчик событий.

Инструкции по созданию пользовательского класса параметров см. в разделе как: Создание параметров приложения.

Параметры ключей и общими настройками

Некоторые элементы управления можно использовать несколько раз в пределах той же форме. В большинстве случаев, требуется эти элементы управления, чтобы сохранить свои собственные отдельные параметры. С помощью SettingsKey свойство IPersistComponentSettings, можно указать уникальная строка, которая используется для однозначного определения нескольких версий элемента управления в форме.

Самый простой способ реализации SettingsKey заключается в использовании Name свойство элемента управления для SettingsKey. При загрузке или сохранении параметры элемента управления, передается значение SettingsKey в SettingsKey свойство ApplicationSettingsBase класса. Параметры приложения используют этот уникальный ключ для сохранения параметров пользователя в XML. В следующем примере кода как <userSettings> раздел может иметь для экземпляра пользовательского элемента управления с именем CustomControl1 , сохраняет параметр в его Text свойство.

<userSettings>  
    <CustomControl1>  
        <setting name="Text" serializedAs="string">  
            <value>Hello, World</value>  
        </setting>  
    </CustomControl1>  
</userSettings>

Все экземпляры элемента управления, который не нужно вводить значение для SettingsKey будут совместно использовать те же параметры.

См. также