C# для профессионалов. Том II

Методы

Имя	Назначение
Close	Закрывает ключ
CreateSubKey	Создает подключ с заданным именем (или открывает его, если он уже существует)
DeleteSubKey	Удаляет заданный подключ
DeleteSubKeyTree	Рекурсивно удаляет подключ и всех его потомков
DeleteValue	Удаляет именованное значение из ключа
GetSubKeyNames	Возвращает массив строк, содержащих имена подключей
GetValue	Возвращает именованное значение
GetValueNames	Возвраает массив строк, содержащих имена всех значений ключа
OpenSubKey	Возвращает ссылку на экземпляр RegistryKey, который представляет заданный подключ
SetValue	Задает именованное значение

Пример: SelfPlacingWindow

Проиллюстрируем использование классов реестра с помощью приложения, которое называется SelfPlacingWindow. Этот пример является простым приложением Windows на C#, которое в действительности почти не имеет свойств. Единственное, что можно сделать в этом приложении, это щелкнуть по кнопке, что приведет к появлению стандартного диалогового окна выбора цветов в Window (представляемому классом System.Windows.Forms.ColorDialog), чтобы можно было выбрать цвет который станет фоновым цветом формы

Это приложение обладает одним важным свойством, отсутствующим практически у всех остальных приложений разрабатываемых в этой книге. Если перетащить окно по экрану, изменить его размер, развернуть на весь экран или свернуть его перед выходом из приложения, оно будет запоминать новое положение, а также цвет фона, чтобы в следующий раз при запуске автоматически восстанавливалось последнее выбранное состояние. Оно запоминает эту информацию, так как записывает ее в реестр, когда закрывается. Таким образом, будут продемонстрированы не только сами классы реестра из .NET, но также типичное их использование, которое наверняка захочется скопировать в любое серьезное разрабатываемое коммерческое приложение Window.

Местом, где SelfPlacingWindow хранил свою информацию в реестре, является ключ HKLM/Software/WroxPress/SelfPlacingWindow. HKLM является обычным местом для хранения информации о конфигурации приложений, но отметим, что оно не является специфическим для пользователя. Вероятно, вам понадобится скопировать эту информацию в улей HK_Users, чтобы каждый пользователь имел свой собственный профиль.

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

Если теперь изменить цвет фона и переместить или изменить размер окна приложения SelfPlacingWindow, оно создаст перед завершением ключ HKLM/Software/WroxPress/SelfPlacingWindow и запишет в него свою новую конфигурационную информацию. Можно проверить эту информацию с помощью regedit:

На этом экране можно видеть, что SelfPlacingWindow помещает ряд значений в ключ реестра. 

Значения Red, Green и Blue задают компоненты цветов, которые формируют выбранный цвет фона. О компонентах цвета подробно рассказывается в главе 21. Любой изображаемый цвет в системе может быть полностью описан этими тремя компонентами, каждый из которых представляется числом между 0 и 255 (или 0x00 и 0xff в шестнадцатеричном представлении). Указанные здесь значения задают ярко-зеленый цвет. Существуют также четыре дополнительных значения REG_DWORD, которые представляют положение и размер окна: X и Y являются координатами верхнего левого угла окна на рабочем столе. Width и Height задают размер окна WindowsState является единственным значением, для которого мы использовали строковый тип данных (REG_SZ), и оно может содержать одну из строк normal, maximized или minimized, в зависимости от конечного состояния окна при выходе из приложения.

Если теперь запустить SelfPlacingWindow снова, то оно будет считывать этот ключ реестра и автоматически позиционировать себя соответственно:

В этот раз, когда происходит выход из SelfPlacingWindow, приложение будет перезаписывать предыдущие настройки в реестре новыми значениями, существующими во время выхода из приложения. Чтобы создать код примера, мы создаем проект Windows Forms в Visual Studio.NET и добавляем окно списка и кнопку, используя набор инструментов среды разработчика. Мы изменим имена этих элементов управления соответственно на listBoxMessages и buttonChooseColor. Также необходимо обеспечить использование пространства имен Microsoft.Win32.

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using System.Data;
using Microsoft.Win32;

Нам необходимо добавить одно поле к основному классу Form1, который будет представлять окно диалога выбора цвета.

public class Form1 : System.Windows.Forms.Form {
 /// <summary>
 /// Обязательная переменная проектировщика.
 /// </summary>
 private System.СomponentModel.Container components;
 private System.Windows.Forms.ListBox ListBoxMessages;
 private system.Windows.Forms.Button buttonChooseColor;
 ColorDialog ChooseColorDialog = new ColorDialog;

Довольно много действий происходит в конструкторе Form1:

public Form1 {
 InitializeComponent;
 buttonChooseColor.Click += new EventHandler(OnClickChooseColor);
 try {
 if (ReadSettings == false)
listBoxMessages.Items.Add("No information in registry");
 else
 listBoxMessages.Items.Add("Information read in from registry");
 StartPosition = FormStartPosition.Manual;
 } catch (Exception e) {
 listBoxMessages.Items.Add("A problem occured reading in data from registry:");
 listBoxMessages.Items.Add(e.Message);
 }
}

В этом конструкторе мы начинаем с создания метода обработки события нажатия пользователем кнопки. Обработчиком является метод с именем OnClickChooseColor (см. ниже). Считывание конфигурационной информации делается с помощью другого метода — ReadSettings. ReadSettings возвращает true, если находит информацию в реестре, и false, если не находит (что будет, по-видимому, иметь место, так как приложение выполняется первый раз). Мы помещаем эту часть конструктора в блок try на случай возникновения каких-либо исключений при считывании значений реестра (это может произойти, если вмешался некоторый пользователь и сделал какие-то изменения с помощью regedit).

Инструкция StartPosition = FormStartPosition.Manual; говорит форме взять свою начальную позицию из свойства DeskTopLocation вместо используемого по умолчанию положения в Window (поведение по умолчанию). Возможные значения берутся из перечисления FormStartPosition.

SelfPlacingWindow также является одним из немногих приложений в этой книге, для которого существенно используется добавление кода в метод Dispose. Напомним, что Dispose вызывается, когда приложение завершается нормально, так что это идеальное место для сохранения конфигурационной информации в реестре. Это делается с помощью другого метода, который будет написан,— SaveSettings: