RegistryProxy.SetValue Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic.MyServices
Assemblagem:
Microsoft.VisualBasic.dll

Escreve um valor numa chave de registo.

Sobrecargas

Name Description
SetValue(String, String, Object)

Escreve um valor numa chave de registo.
SetValue(String, String, Object, RegistryValueKind)

Escreve um valor numa chave de registo.

SetValue(String, String, Object)

Escreve um valor numa chave de registo.

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 escrita. Required.

valueName
String

String. Nome do valor a escrever. Required.

value
Object

Object. Valor a escrever. Required.

Exceções

ArgumentNullException

value é Nothing.

ArgumentException

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

-ou-

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

UnauthorizedAccessException

O RegistryKey é apenas de leitura e, portanto, não pode ser escrito; por exemplo, é um nó ao nível da raiz, ou não foi aberto com acesso de escrita.

SecurityException

O utilizador não tem as permissões necessárias para criar ou modificar chaves de registo.

Exemplos

Este exemplo define o valor FontColor para "vermelho" na tonalidade HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Observações

Se a chave ou valor especificado não existir, é criado.

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

Para Veja
Defina um valor numa chave de registo Como: Criar uma chave de registo e definir o seu valor

Ver também

Aplica-se a

SetValue(String, String, Object, RegistryValueKind)

Escreve um valor numa chave de registo.

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 escrita. Required.

valueName
String

String. Nome do valor a escrever. Required.

value
Object

Object. Valor a escrever. Required.

valueKind
RegistryValueKind

RegistryValueKind. Required.

Exceções

ArgumentNullException

value é Nothing.

ArgumentException

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

-ou-

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

-ou-

O tipo de value não corresponde ao tipo de dados do registo especificado por valueKind, pelo que os dados não podem ser convertidos corretamente.

UnauthorizedAccessException

O RegistryKey é apenas de leitura e, portanto, não pode ser escrito; por exemplo, é um nó ao nível da raiz, ou não foi aberto com acesso de escrita.

SecurityException

O utilizador não tem as permissões necessárias para criar ou modificar chaves de registo.

Exemplos

Este exemplo define o valor FontColor para "vermelho" na tonalidade HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Observações

Se a chave ou valor especificado não existir, é criado.

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

Para Veja
Defina um valor numa chave de registo Como: Criar uma chave de registo e definir o seu valor

Ver também

Aplica-se a