Interaction.GetAllSettings(String, String) Método
Definição
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 uma lista de configurações de chave e seus respectivos valores (originalmente criados com SaveSetting) da entrada de um aplicativo no registro Windows. O uso do My recurso oferece maior produtividade e desempenho em operações do Registro do que GetAllSettings. Para obter mais informações, consulte 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 que contém o nome do aplicativo ou projeto cujas configurações de chave são solicitadas.
- Section
- String
Required.
String expressão que contém o nome da seção cujas configurações de chave são solicitadas.
GetAllSettings retorna um objeto que contém uma matriz bidimensional de cadeias de caracteres. As cadeias de caracteres contêm todas as configurações de chave na seção especificada, além de seus valores correspondentes.
Retornos
Uma lista de configurações de chave e seus respectivos valores (originalmente criados com SaveSetting) da entrada de um aplicativo no registro Windows.
O uso do My recurso oferece maior produtividade e desempenho em operações do Registro do que GetAllSettings. Para obter mais informações, consulte Registry.
Exceções
O usuário não está conectado.
Exemplos
Este exemplo primeiro usa a função SaveSetting para fazer entradas no registro Windows para o aplicativo especificado como AppName e, em seguida, usa a função GetAllSettings para exibir as configurações. Observe que nomes e Section nomes de aplicativos não podem ser recuperados com GetAllSettings. Por fim, a DeleteSetting função remove as entradas do aplicativo.
' 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")
Comentários
GetAllSettings retornará um não inicializado Object se houver AppName ou Section não.
Como ela opera sob a chave do HKEY_LOCAL_USER Registro, que não está ativa até que um usuário faça logon interativamente, GetAllSettings exige 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 ou nas chaves do HKEY_LOCAL_MACHINE\Software\HKEY_USER\DEFAULT\Software Registro.