Interaction.GetSetting(String, String, String, String) Método

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retorna um valor de configuração de chave da entrada de um aplicativo no registro Windows. O My recurso oferece maior produtividade e desempenho em operações do Registro do que GetAllSettings. Para obter mais informações, consulte Registry.

public static string GetSetting(string AppName, string Section, string Key, string Default = "");
static member GetSetting : string * string * string * string -> string
Public Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As String

Parâmetros

AppName
String

Required. String expressão que contém o nome do aplicativo ou projeto cuja configuração de chave é solicitada.

Section
String

Required. String expressão que contém o nome da seção na qual a configuração da chave é encontrada.

Key
String

Required. String expressão que contém o nome da configuração de chave a ser retornada.

Default
String

Optional. Expressão que contém o valor a ser retornado se nenhum valor for definido na Key configuração. Se omitido, Default supõe-se que seja uma cadeia de caracteres de comprimento zero ("").

Retornos

String

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

O My recurso oferece maior produtividade e desempenho em operações do Registro do que GetAllSettings.

Exceções

ArgumentException

Um ou mais argumentos não String são expressões ou o usuário não está conectado.

Exemplos

Este exemplo primeiro usa a função SaveSetting para fazer entradas no registro Windows para o aplicativo especificado como AppName e, em seguida, usa a função GetSetting para exibir uma das configurações. Como o Default argumento é especificado, há garantia de que algum valor seja retornado. Observe que Section os nomes não podem ser recuperados com GetSetting. Por fim, a DeleteSetting função remove todas as entradas 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")

Comentários

Se qualquer um dos itens nomeados nos GetSetting argumentos não existir, GetSetting retornará um valor de Default.

Como ela opera sob a chave do HKEY_LOCAL_USER Registro, que não está ativa até que um usuário faça logon interativamente, GetSetting exige que um usuário seja conectado.

As configurações do Registro que devem ser acessadas de um processo não interativo (como Mtx.exe) devem ser armazenadas nas chaves ou nas chaves do HKEY_LOCAL_MACHINE\Software\HKEY_USER\DEFAULT\Software Registro.

GetSetting requer ReadRegistryPermission.

Aplica-se a

Confira também