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 melhor produtividade e desempenho em operações do Registro do que o 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

Obrigatórios. Expressão String que contém o nome do aplicativo ou do projeto cuja configuração de chave é solicitada.

Section

String

Obrigatórios. Expressão String que contém o nome da seção na qual a configuração de chave está localizada.

Key

String

Obrigatórios. Expressão String que contém o nome da configuração de chave a ser retornada.

Default

String

Opcional. A expressão que contém o valor a ser retornado se nenhum valor for definido na configuração Key. Se for omitido, Default será considerado uma cadeia de tamanho zero ("").

Retornos

String

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

O recurso My oferece melhor produtividade e desempenho em operações do Registro do que o 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 SaveSetting função para fazer entradas no Registro do Windows para o aplicativo especificado como AppNamee, em seguida, usa a GetSetting função 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 ele opera sob a chave do HKEY_LOCAL_USER Registro, 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 nas chaves do HKEY_LOCAL_MACHINE\Software\ registro ou HKEY_USER\DEFAULT\Software .

GetSetting requer ReadRegistryPermission.

Confira também

• DeleteSetting(String, String, String)
• GetAllSettings(String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• RegistryPermission
• Lendo e gravando a partir do Registro (Visual Basic)