Поделиться через


RegistryProxy.SetValue Метод

Определение

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

Перегрузки

SetValue(String, String, Object)

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

SetValue(String, String, Object, RegistryValueKind)

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

SetValue(String, String, Object)

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

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. Значение, которое требуется записать Обязательный.

Исключения

value имеет значение Nothing.

Параметр keyName не начинается с правильного корневого раздела реестра.

-или-

Значение параметра valueName длиннее максимально допустимой длины (255 знаков).

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

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

Примеры

В этом примере задается значение FontColor "red" в ключе 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 метод .

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

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

Применяется к

SetValue(String, String, Object, RegistryValueKind)

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

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. Обязательный.

Исключения

value имеет значение Nothing.

Параметр keyName не начинается с правильного корневого раздела реестра.

-или-

Значение параметра keyName длиннее максимально допустимой длины (255 знаков).

-или-

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

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

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

Примеры

В этом примере задается значение FontColor "red" в ключе 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 метод .

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

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

Применяется к