Método My.Computer.Registry.SetValue
Grava um valor em uma chave de registro
' Usage
My.Computer.Registry.SetValue(keyName ,valueName ,value)
My.Computer.Registry.SetValue(keyName ,valueName ,value ,valueKind)
' Declaration
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object _
)
' -or-
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object, _
ByVal valueKind As Microsoft.Win32.RegistryValueKind _
)
Parâmetros
keyName
String.Nome da chave a serem gravados.Obrigatório.valueName
String.Nome do valor a ser gravado.Obrigatório.value
Object.Valor a ser gravado.Obrigatório.valueKind
RegistryValueKind.Obrigatório.
Comentários
Se o valor ou chave especificada não existem, ele é criado.
Exceções
As seguintes condições podem causar uma exceção:
O nome da chave é Nothing (ArgumentNullException).
O nome da chave excede o limite de 255 caracteres (ArgumentException).
A seção especificada é inválida (ArgumentException).
A chave é fechada (IOException).
O caminho é inválido (IOException).
A chave do registro é somente leitura (UnauthorizedAccessException).
Tarefas
A seguir tem-se um exemplo de uma tarefa que envolve o método My.Computer.Registry.SetValue.
Para |
Consulte |
|---|---|
Definir um valor em uma chave do Registro |
Como: Criar uma chave do Registro e definir os valores no Visual Basic |
Exemplo
Este exemplo define o valor FontColorpara "red" na chave HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.
My.Computer.Registry.LocalMachine.OpenSubKey _
("Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
Requisitos
Namespace:Microsoft.VisualBasic.MyServices
Classe:RegistryProxy (fornece acesso a Registry)
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)
Permissões
A permissão a seguir pode ser necessária:
Permissão |
Descrição |
|---|---|
Controla a capacidade para acessar o Registro.Enumerações associadas: RegistryPermissionAccess.Write, RegistryPermissionAccess.Create. |
Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.
Consulte também
Tarefas
Solução de problemas: Manipulando o Registro
Conceitos
Leitura do e gravação para o Registro usando My
Acesso ao Registro para usuários do Visual Basic 6.0