RegistryProxy.SetValue Método

Definição

Namespace:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll

Grava um valor em uma chave do Registro.

Sobrecargas

Nome Description
SetValue(String, String, Object)

Grava um valor em uma chave do Registro.
SetValue(String, String, Object, RegistryValueKind)

Grava um valor em uma chave do Registro.

SetValue(String, String, Object)

Grava um valor em uma chave do 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. Nome da chave a ser gravada. Required.

valueName
String

String. Nome do valor a ser gravado. Required.

value
Object

Object. Valor a ser gravado. Required.

Exceções

ArgumentNullException

value é Nothing.

ArgumentException

keyName não começa com uma raiz válida do Registro.

-ou-

valueName é maior que o comprimento máximo permitido (255 caracteres).

UnauthorizedAccessException

O RegistryKey é somente leitura e, portanto, não pode ser gravado; por exemplo, é um nó de nível raiz ou não foi aberto com acesso de gravação.

SecurityException

O usuário não tem as permissões necessárias para criar ou modificar chaves do Registro.

Exemplos

Este exemplo define o valor FontColor como "vermelho" na chave HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Comentários

Se a chave ou o valor especificado não existir, ele será criado.

Aqui está um exemplo de uma tarefa que envolve o My.Computer.Registry.SetValue método.

Para Veja
Definir um valor em uma chave do Registro Como criar uma chave do Registro e definir seu valor

Confira também

Aplica-se a

SetValue(String, String, Object, RegistryValueKind)

Grava um valor em uma chave do 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. Nome da chave a ser gravada. Required.

valueName
String

String. Nome do valor a ser gravado. Required.

value
Object

Object. Valor a ser gravado. Required.

valueKind
RegistryValueKind

RegistryValueKind. Required.

Exceções

ArgumentNullException

value é Nothing.

ArgumentException

keyName não começa com uma raiz válida do Registro.

-ou-

keyName é maior que o comprimento máximo permitido (255 caracteres).

-ou-

O tipo de não corresponde ao tipo de value dados do Registro especificado, valueKindportanto, os dados não podem ser convertidos corretamente.

UnauthorizedAccessException

O RegistryKey é somente leitura e, portanto, não pode ser gravado; por exemplo, é um nó de nível raiz ou não foi aberto com acesso de gravação.

SecurityException

O usuário não tem as permissões necessárias para criar ou modificar chaves do Registro.

Exemplos

Este exemplo define o valor FontColor como "vermelho" na chave HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Comentários

Se a chave ou o valor especificado não existir, ele será criado.

Aqui está um exemplo de uma tarefa que envolve o My.Computer.Registry.SetValue método.

Para Veja
Definir um valor em uma chave do Registro Como criar uma chave do Registro e definir seu valor

Confira também

Aplica-se a