RegistryProxy.SetValue Método

Definición

Escribe un valor en una clave del Registro.

Sobrecargas

SetValue(String, String, Object)

Escribe un valor en una clave del Registro.

SetValue(String, String, Object, RegistryValueKind)

Escribe un valor en una clave del Registro.

SetValue(String, String, Object)

Escribe un valor en una clave del Registro.

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

Parámetros

keyName
String

String. Nombre de la clave en la que se va a escribir. Obligatorio.

valueName
String

String. Nombre del valor que se va a escribir. Obligatorio.

value
Object

Object. Valor que se va a escribir. Obligatorio.

Excepciones

value es Nothing.

keyName no comienza con una clave raíz del Registro válida.

O bien

valueName supera la longitud máxima permitida (255 caracteres).

RegistryKey es de solo lectura y, por tanto, no permite la escritura (por ejemplo, es un nodo del nivel raíz o no se ha abierto con acceso de escritura).

El usuario no tiene los permisos necesarios para crear o modificar claves del Registro.

Ejemplos

En este ejemplo se establece el valor FontColor en "rojo" en la clave HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Comentarios

Si la clave o el valor especificados no existen, se crea.

Este es un ejemplo de una tarea que implica el My.Computer.Registry.SetValue método .

En Vea
Establecimiento de un valor en una clave del Registro Procedimiento para crear una clave del Registro y establecer su valor

Consulte también

Se aplica a

.NET Framework 4.8.1 y otras versiones
Producto Versiones
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 5, 6, 7, 8, 9

SetValue(String, String, Object, RegistryValueKind)

Escribe un valor en una clave del Registro.

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

Parámetros

keyName
String

String. Nombre de la clave en la que se va a escribir. Obligatorio.

valueName
String

String. Nombre del valor que se va a escribir. Obligatorio.

value
Object

Object. Valor que se va a escribir. Obligatorio.

valueKind
RegistryValueKind

RegistryValueKind. Obligatorio.

Excepciones

value es Nothing.

keyName no comienza con una clave raíz del Registro válida.

O bien

keyName supera la longitud máxima permitida (255 caracteres).

o bien

El tipo de value no coincide con el tipo de datos del Registro especificado por valueKind; por consiguiente, no se pueden convertir los datos correctamente.

RegistryKey es de solo lectura y, por tanto, no se puede escribir en ella; por ejemplo, se trata de un nodo del nivel raíz, o no se ha abierto con acceso de escritura.

El usuario no tiene los permisos necesarios para crear o modificar claves del Registro.

Ejemplos

En este ejemplo se establece el valor FontColor en "rojo" en la clave HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Comentarios

Si la clave o el valor especificados no existen, se crea.

Este es un ejemplo de una tarea que implica el My.Computer.Registry.SetValue método .

En Vea
Establecimiento de un valor en una clave del Registro Procedimiento para crear una clave del Registro y establecer su valor

Consulte también

Se aplica a

.NET Framework 4.8.1 y otras versiones
Producto Versiones
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 5, 6, 7, 8, 9