Função SaveSetting

Artigo
08/25/2010

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")