RegistryProxy.SetValue Método

  • Referência

Definição

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

Grava um valor em uma chave do Registro.

Sobrecargas

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. O nome da chave para a qual gravar. Obrigatórios.

valueName
String

String. O nome do valor a ser gravado. Obrigatórios.

value
Object

Object. O valor a ser gravado. Obrigatórios.

Exceções

ArgumentNullException

value é Nothing.

ArgumentException

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

- ou -

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

UnauthorizedAccessException

O RegistryKey é somente leitura e, portanto, não pode ser usado para gravação; por exemplo, ele é 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 Consulte
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. O nome da chave para a qual gravar. Obrigatórios.

valueName
String

String. O nome do valor a ser gravado. Obrigatórios.

value
Object

Object. O valor a ser gravado. Obrigatórios.

valueKind
RegistryValueKind

RegistryValueKind. Obrigatórios.

Exceções

ArgumentNullException

value é Nothing.

ArgumentException

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

- ou -

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

- ou -

O tipo de value não corresponde ao tipo de dados do Registro especificado pelo valueKind e, portanto, não é possível converter os dados corretamente.

UnauthorizedAccessException

O RegistryKey é somente leitura e, portanto, não pode ser usado para gravação; por exemplo, ele é 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 Consulte
Definir um valor em uma chave do Registro Como: Criar uma chave do Registro e definir seu valor

Confira também

Aplica-se a