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

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: Interaction.vb

Origem:: Interaction.vb

Origem:: Interaction.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

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.

Aplica-se a

Compartilhar via