RegistryProxy.SetValue Método

Definição

Namespace:

Microsoft.VisualBasic.MyServices

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

• RegistryValueKind
• SetValue
• Objetos (Visual Basic)
• Lendo e gravando a partir do Registro (Visual Basic)
• Segurança e Registro (Visual Basic)

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

• RegistryValueKind
• SetValue
• Objetos (Visual Basic)
• Lendo e gravando a partir do Registro (Visual Basic)
• Segurança e Registro (Visual Basic)