Share via

RegistryProxy.SetValue Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.MyServices
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

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(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)

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

ArgumentNullException

value es Nothing.

ArgumentException

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

O bien

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

UnauthorizedAccessException

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).

SecurityException

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

SetValue(String, String, Object, RegistryValueKind)

Escribe un valor en una clave del Registro.

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)

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

ArgumentNullException

value es Nothing.

ArgumentException

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.

UnauthorizedAccessException

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.

SecurityException

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