RegistryProxy.SetValue Метод

Определение

Пространство имен:

Microsoft.VisualBasic.MyServices

Сборка:

Microsoft.VisualBasic.Forms.dll

Записывает значение в раздел реестра.

Перегрузки

Имя	Описание
SetValue(String, String, Object)	Записывает значение в раздел реестра.
SetValue(String, String, Object, RegistryValueKind)	Записывает значение в раздел реестра.

SetValue(String, String, Object)

Исходный код:

RegistryProxy.vb

Записывает значение в раздел реестра.

public:
 void SetValue(System::String ^ keyName, System::String ^ valueName, System::Object ^ value);

public void SetValue(string keyName, string valueName, object value);

member this.SetValue : string * string * obj -> unit

Public Sub SetValue (keyName As String, valueName As String, value As Object)

Параметры

keyName

String

String. Имя ключа для записи. Обязательно.

valueName

String

String. Имя записанного значения. Обязательно.

value

Object

Object. Значение для записи. Обязательно.

Исключения

ArgumentNullException

value равно Nothing.

ArgumentException

keyName Не начинается с допустимого корневого каталога реестра.

–или–

valueName больше допустимой максимальной длины (255 символов).

UnauthorizedAccessException

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

SecurityException

У пользователя нет разрешений, необходимых для создания или изменения разделов реестра.

Примеры

В этом примере значение FontColor имеет значение "красный" в ключе HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

My.Computer.Registry.LocalMachine.OpenSubKey(
  "Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")

Комментарии

Если указанный ключ или значение не существует, он создается.

Ниже приведен пример задачи, включающей My.Computer.Registry.SetValue метод.

Кому	Смотри
Установка значения в разделе реестра	Практическое руководство. Создание раздела реестра и установка его значения

См. также раздел

• RegistryValueKind
• SetValue
• Объекты (Visual Basic)
• Чтение и запись в реестр (Visual Basic)
• Security и Реестр (Visual Basic)

SetValue(String, String, Object, RegistryValueKind)

Исходный код:

RegistryProxy.vb

Записывает значение в раздел реестра.

public:
 void SetValue(System::String ^ keyName, System::String ^ valueName, System::Object ^ value, Microsoft::Win32::RegistryValueKind valueKind);

public void SetValue(string keyName, string valueName, object value, Microsoft.Win32.RegistryValueKind valueKind);

member this.SetValue : string * string * obj * Microsoft.Win32.RegistryValueKind -> unit

Public Sub SetValue (keyName As String, valueName As String, value As Object, valueKind As RegistryValueKind)

Параметры

keyName

String

String. Имя ключа для записи. Обязательно.

valueName

String

String. Имя записанного значения. Обязательно.

value

Object

Object. Значение для записи. Обязательно.

valueKind

RegistryValueKind

RegistryValueKind. Обязательно.

Исключения

ArgumentNullException

value равно Nothing.

ArgumentException

keyName Не начинается с допустимого корневого каталога реестра.

–или–

keyName больше допустимой максимальной длины (255 символов).

–или–

Тип value данных реестра не соответствует типу данных реестра, заданному соответствующим valueKindобразом, поэтому данные не могут быть преобразованы должным образом.

UnauthorizedAccessException

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

SecurityException

У пользователя нет разрешений, необходимых для создания или изменения разделов реестра.

Примеры

В этом примере значение FontColor имеет значение "красный" в ключе HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

My.Computer.Registry.LocalMachine.OpenSubKey(
  "Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")

Комментарии

Если указанный ключ или значение не существует, он создается.

Ниже приведен пример задачи, включающей My.Computer.Registry.SetValue метод.

Кому	Смотри
Установка значения в разделе реестра	Практическое руководство. Создание раздела реестра и установка его значения

См. также раздел

• RegistryValueKind
• SetValue
• Объекты (Visual Basic)
• Чтение и запись в реестр (Visual Basic)
• Security и Реестр (Visual Basic)