Compartilhar via


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

Definição

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

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

Exceções

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

Confira também