Более распространена ситуация, когда приложению необходимо убедиться, что некоторые данные присутствуют в реестре, другими словами, создать соответствующие ключи, если они еще не существуют, но ничего не делать, если они существуют. Метод
CreateSubKey
прекрасно с этим справляется. В отличие, например, от ситуации с
FileInfo.Open
у
CreateSubKey
нет возможности случайно удалить какие-либо данные. Если целью действительно является удаление ключей реестра, то необходимо явно вызвать метод
RegistryKey.Delete
. Это имеет смысл с учетом важности реестра для Windows. Меньше всего хотелось бы полностью разрушить Windows, удалив пару важных ключей во время отладки обращений к реестру в C#.
Когда ключ реестра для чтения или модификации найден, можно использовать методы
SetValue
или
GetValue
для задания или получения из них данных. Оба эти метода получают в качестве параметра строку, задающую имя значения, a
SetValue
требует дополнительно ссылку на объект, содержащий детали значения. Так как параметр определяется как объектная ссылка, то он может действительности быть ссылкой на любой класс по желанию.
SetValue
будет определять по типу реально предоставленного класса, как задать значение
int IntValue = (int)HkMine.Get.Value("MyIntValue");
И наконец, по окончании чтения или модификации данных ключ необходимо закрыть:
HkMine.Close;
Помимо этих методов,
RegistryKey
реализует большое число других методов и свойств. Таблицы представляют выборку наиболее употребительных:
Свойства
Имя свойства
Назначение
Name
Имя ключа (только для чтения)
SubKeyCount
Число потомков этого ключа
ValueCount
Сколько значений содержит ключ
Методы
Имя
Назначение
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
. Также необходимо обеспечить использование пространства имен