Compartilhar via


Função SaveSetting

Salva ou cria uma entrada de aplicativo no Registro do Windows.

O recurso My dá a você maior produtividade e desempenho em registro de operações que SaveSetting.Para obter mais informações, consulte Objeto My.Computer.Registro.

Public Sub SaveSetting( _
   ByVal AppName As String, _ 
   ByVal Section As String, _
   ByVal Key As String, _
   ByVal Setting As String _
)

Parâmetros

  • AppName
    Obrigatório.String expressão que contém o nome do aplicativo ou projeto ao qual a configuração se aplica.

  • Section
    Obrigatório.String expressão que contém o nome da seção na qual o chave configuração está sendo salvo.

  • Key
    Obrigatório.String expressão que contém o nome da configuração principal seja salvo.

  • Setting
    Obrigatório.Expressão que contém o valor para o qual Key está sendo definida.

Exceções

Tipo de exceção

Número de erro

Condição

ArgumentException

5

Chave do registro não pôde ser criada, ou o usuário não fez logon.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

A função SaveSetting adiciona a chave para HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

Se a configuração principal não puder ser salva por algum motivo, ocorrerá um erro.

SaveSetting requer que um usuário tenha feito logon desde que se opere sob a chave de registro HKEY_LOCAL_USER , que não está ativa até que um usuário efetue logon interativamente.

Configurações de registro que devem acessadas a partir de um processo não interativo (como Mtx.exe) devem ser armazenadas em HKEY_LOCAL_MACHINE\Software\ ou as chaves de registro HKEY_USER\DEFAULT\Software.

SaveSetting requer permissões de registro Write e Create.

Exemplo

O exemplo a seguir primeiro usa a função SaveSetting para fazer as entradas no registro do Windows para o aplicativo MyApp e em seguida, usa a função DeleteSetting para removê-las.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")

Anotações Developer Dispositivo Inteligente

Não há suporte para esta função.

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**Interaction

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Conceitos

Tarefas comuns do Registro

Referência

Função DeleteSetting

Função GetAllSettings

Função GetSetting

RegistryPermission