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
метод .
Кому | См. |
---|---|
Установка значения в разделе реестра | Практическое руководство. Создание раздела реестра и задание его значения |
См. также раздел
- RegistryValueKind
- SetValue
- Объекты (Visual Basic)
- Чтение данных из реестра и запись в реестр (Visual Basic)
- Безопасность и реестр (Visual Basic)
Применяется к
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
метод .
Кому | См. |
---|---|
Установка значения в разделе реестра | Практическое руководство. Создание раздела реестра и задание его значения |
См. также раздел
- RegistryValueKind
- SetValue
- Объекты (Visual Basic)
- Чтение данных из реестра и запись в реестр (Visual Basic)
- Безопасность и реестр (Visual Basic)