Função GetSetting

Artigo
08/25/2010

Retorna um valor de configuração da chave de entrada do aplicativo no registro do Windows.

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

Public Function GetSetting( _
   ByVal AppName As String, _
   ByVal Section As String, _
   ByVal Key As String, _
   Optional ByVal Default As String = "" _
) As String

Parâmetros

AppName
Obrigatório.String expressão que contém o nome do aplicativo ou projeto cuja chave configuração é solicitada.
Section
Obrigatório.String expressão que contém o nome da seção em que se encontra a configuração da chave.
Key
Obrigatório.String expressão que contém o nome da configuração principal para retornar.
Default
Opcional.Expressão que contém o valor a ser retornado caso nenhum valor estiver definido no Key a configuração. Se omitido, Defaultsupõe-se que seja uma cadeia de comprimento zero ("").

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Um ou mais argumentos não são String expressões ou usuário não tiver feito 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

Se qualquer um dos itens nomeados no GetSetting argumentos não existirem, GetSetting Retorna um valor Default.

Como ele funciona com o HKEY_LOCAL_USER chave do registro, que não está ativo até que um usuário fizer logon interativamente, GetSetting exigir que um usuário esteja conectado.

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.

GetSetting requires ReadRegistry Permission.

Exemplo

Este exemplo usa primeiro o SaveSetting função para criar entradas no registro do Windows para o aplicativo especificado sistema autônomo AppNamee, em seguida, usa o GetSetting função para exibir uma das configurações. Porque o Default argumento for especificado, é garantido algum valor a ser retornado. Observe que Section nomes não podem ser recuperados com GetSetting. Finalmente, a DeleteSetting função remove as entradas de todas as do aplicativo.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
DeleteSetting("MyApp")