Метод My.Computer.Registry.SetValue
Обновлен: Ноябрь 2007
Записывает значение в раздел реестра.
' Usage
My.Computer.Registry.SetValue(keyName ,valueName ,value)
My.Computer.Registry.SetValue(keyName ,valueName ,value ,valueKind)
' Declaration
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object _
)
' -or-
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object, _
ByVal valueKind As Microsoft.Win32.RegistryValueKind _
)
Параметры
keyName
String. Имя раздела, в который требуется выполнить запись. Обязательный.valueName
String. Имя записываемого значения. Обязательный.value
Object. Записываемое значение. Обязательный.valueKind
RegistryValueKind. Обязательный.
Заметки
Если указанный раздел или значение не существуют, он будет создан.
Исключения
При следующих условиях возможно возникновение исключения.
Имя раздела представляет собой значение Nothing (ArgumentNullException).
Длина имени раздела превышает ограничение в 255 знаков (ArgumentException).
Заданный куст недопустим (ArgumentException).
Раздел является закрытым (IOException).
Неправильный путь (IOException).
Раздел реестра доступен только для чтения (UnauthorizedAccessException).
Задачи
Ниже приведен пример задачи, вызывающей метод My.Computer.Registry.SetValue.
To |
См. разделы |
|---|---|
Задание значения в разделе реестра |
Практическое руководство. Создание раздела реестра и задание его значения в Visual Basic |
Пример
В этом примере устанавливается значение "красный" для параметра FontColor в разделе HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.
My.Computer.Registry.LocalMachine.OpenSubKey _
("Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
Требования
Пространство имен:Microsoft.VisualBasic.MyServices
Класс:RegistryProxy (предоставляет доступ к Registry)
Сборка. Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)
Разрешения
Могут потребоваться следующие разрешения:
Разрешение |
Описание |
|---|---|
Управляет доступом к реестру. Связанные перечисления: RegistryPermissionAccess.Write, RegistryPermissionAccess.Create. |
Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.
См. также
Задачи
Устранение неполадок, связанных с управлением реестром
Основные понятия
Чтение и запись в реестр с использованием объекта My
Доступ к реестру (для пользователей Visual Basic 6.0)