Interaction.GetSetting(String, String, String, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um valor de definição de chave a partir da entrada da aplicação no registo do Windows. A My funcionalidade proporciona-lhe maior produtividade e desempenho nas operações de registo do que GetAllSettings. Para obter mais informações, veja Registry.
public static string GetSetting(string AppName, string Section, string Key, string Default = "");static member GetSetting : string * string * string * string -> stringPublic Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As StringParâmetros
- AppName
- String
Required.
String expressão contendo o nome da aplicação ou projeto cuja configuração de chave é solicitada.
- Section
- String
Required.
String expressão contendo o nome da secção onde se encontra a definição de chave.
- Key
- String
Required.
String expressão contendo o nome da definição de chave a devolver.
- Default
- String
Optional. Expressão contendo o valor a devolver caso não haja valor definido na Key definição. Se omitido, Default assume-se que é uma sequência de comprimento zero ("").
Devoluções
Um valor de definição de chave a partir da entrada de uma aplicação no registo do Windows.
A My funcionalidade proporciona-lhe maior produtividade e desempenho nas operações de registo do que GetAllSettings.
Exceções
Um ou mais argumentos não String são expressões, ou o utilizador não está logado.
Exemplos
Este exemplo usa primeiro a função SaveSetting para fazer entradas no registo de Windows para a aplicação especificada como AppName, e depois usa a função GetSetting para mostrar uma das definições. Como o Default argumento é especificado, algum valor é garantido de ser devolvido. Note que Section nomes não podem ser recuperados com GetSetting. Finalmente, a DeleteSetting função remove todas as entradas da aplicação.
' 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")
Observações
Se algum dos itens nomeados nos GetSetting argumentos não existir, GetSetting devolve um valor de Default.
Como opera sob a HKEY_LOCAL_USER chave do registo, que não está ativa até que o utilizador faça login interativo, GetSetting é necessário que o utilizador esteja logado.
As definições do registo que devem ser acedidas a partir de um processo não interativo (como Mtx.exe) devem ser armazenadas sob as HKEY_LOCAL_MACHINE\Software\ ou as HKEY_USER\DEFAULT\Software chaves do registo.
GetSetting requer ReadRegistryPermission.