Interaction.GetAllSettings(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 uma lista de definições de chave e respetivos valores (originalmente criados com SaveSetting) a partir da entrada da aplicação no registo Windows. Usar esta My funcionalidade dá-lhe maior produtividade e desempenho nas operações de registo do que GetAllSettings. Para obter mais informações, veja Registry.
public:
static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);public static string[,] GetAllSettings(string AppName, string Section);static member GetAllSettings : string * string -> string[,]Public Function GetAllSettings (AppName As String, Section As String) As String(,)Parâmetros
- AppName
- String
Required.
String expressão contendo o nome da aplicação ou projeto cujas definições de chave são solicitadas.
- Section
- String
Required.
String expressão contendo o nome da secção cujas definições de chave são solicitadas.
GetAllSettings devolve um objeto que contém um array bidimensional de cordas. As cadeias contêm todas as definições de tonalidade na secção especificada, mais os respetivos valores.
Devoluções
Uma lista de definições-chave e os respetivos valores (originalmente criados com SaveSetting) a partir da entrada de uma aplicação no registo Windows.
Usar esta My funcionalidade dá-lhe maior produtividade e desempenho nas operações de registo do que GetAllSettings. Para obter mais informações, veja Registry.
Exceções
O utilizador não está logado.
Exemplos
Este exemplo usa primeiro a função SaveSetting para fazer entradas no registo Windows da aplicação especificada como AppName, depois usa a função GetAllSettings para mostrar as definições. Note que os nomes das aplicações e Section nomes não podem ser recuperados com GetAllSettings. Finalmente, a DeleteSetting função remove as entradas da aplicação.
' Object to hold 2-dimensional array returned by GetAllSettings.
' Integer to hold counter.
Dim MySettings(,) As String
Dim intSettings As Integer
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Retrieve the settings.
MySettings = GetAllSettings("MyApp", "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
WriteLine(1, MySettings(intSettings, 0))
WriteLine(1, MySettings(intSettings, 1))
Next intSettings
DeleteSetting("MyApp")
Observações
GetAllSettings devolve um não inicializado Object se qualquer um AppName dos dois ou Section não existir.
Como opera sob a HKEY_LOCAL_USER chave do registo, que não está ativa até que o utilizador faça login interativo, GetAllSettings é 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.