RegistryProxy.SetValue Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Escribe un valor en una clave del Registro.
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. |
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
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
- RegistryValueKind
- SetValue
- Objetos (Visual Basic)
- Leer y escribir en el Registro (Visual Basic)
- La seguridad y el Registro (Visual Basic)
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 |
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
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
- RegistryValueKind
- SetValue
- Objetos (Visual Basic)
- Leer y escribir en el Registro (Visual Basic)
- La seguridad y el Registro (Visual Basic)
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 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: