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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting (string AppName, string Section, string Key, string? Default = "");

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

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

Section

String

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

Key

String

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

Default

String

Opcional. Expressão que contém o valor a ser retornado se nenhum valor for definido na configuração Key. Se omitida, Default será considerada uma cadeia de caracteres de comprimento zero ("").

Retornos

String

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

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

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentException

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

Exemplos

Este exemplo primeiro usa a função SaveSetting para fazer entradas no Registro do Windows para o aplicativo especificado como AppNamee, em seguida, usa a função GetSetting para exibir uma das configurações. Como o argumento Default é especificado, há garantia de que algum valor seja retornado. Observe que Section nomes não podem ser recuperados com GetSetting. Por fim, a função DeleteSetting 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 algum dos itens nomeados nos argumentos GetSetting não existir, GetSetting retornará um valor de Default.

Como ela opera sob a chave do Registro HKEY_LOCAL_USER, que não está ativa até que um usuário faça logon interativamente, GetSetting requer 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 no HKEY_LOCAL_MACHINE\Software\ ou nas chaves do registro HKEY_USER\DEFAULT\Software.

GetSetting requer ReadRegistryPermission.

Confira também

• DeleteSetting(String, String, String)
• GetAllSettings(String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• RegistryPermission
• leitura e gravação no Registro (Visual Basic)