Função GetAllSettings

Artigo
08/25/2010

Retorna uma lista de chave configurações e seus respectivos valores (originalmente criados com SaveSetting) entrada de um aplicativo no registro do Windows.

Usando o My recurso fornece maior produtividade e desempenho em operações de registro que GetAllSettings. Para obter mais informações, consulte Objeto My.Computer.Registro.

Public Function GetAllSettings( _
   ByVal AppName As String, _ 
   ByVal Section As String _
) As String(,)

Parâmetros

AppName
Obrigatório.String expressão que contém o nome do aplicativo ou projeto cuja chave configurações são solicitadas.
Section
Obrigatório.String expressão que contém o nome da seção cujo chave configurações são solicitadas. GetAllSettings Retorna um objeto que contém uma matriz bidimensional de seqüências de caracteres. As seqüências conter todas as configurações principais da seção especificada, além de seus valores correspondentes.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Usuário não está conectado.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

GetAllSettings Retorna um não inicializado Object Se qualquer uma AppName ou Section não existe.

Como ele funciona com o HKEY_LOCAL_USER chave do registro, que não está ativo até que um usuário fizer logon interativamente, GetAllSettings exigir que um usuário esteja conectado.

Configurações de registro que devem acessadas a partir de um processo não interativo (como Mtx.exe) devem ser armazenadas em HKEY_LOCAL_MACHINE\Software\ ou as chaves de registro HKEY_USER\DEFAULT\Software.

Exemplo

Este exemplo usa primeiro o SaveSetting função para criar entradas no registro do Windows para o aplicativo especificado sistema autônomo AppName, em seguida, usa o GetAllSettings função para exibir sistema autônomo configurações. Observe que aplicativo nomes e Section nomes não podem ser recuperados com GetAllSettings. Finalmente, a DeleteSetting função remove 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")