Interaction.GetAllSettings(String, String) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

Retorna uma lista de configurações de chave e seus respectivos valores (originalmente criados com SaveSetting) da entrada de um aplicativo no Registro do Windows. O uso do recurso My oferece melhor produtividade e desempenho em operações do Registro do que o GetAllSettings. Para obter mais informações, consulte Registry.

public:
 static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string[,]? GetAllSettings (string AppName, string Section);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetAllSettings : string * string -> string[,]

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

Parâmetros

AppName

String

Obrigatórios. Expressão String que contém o nome do aplicativo ou do projeto cujas configurações de chave são solicitadas.

Section

String

Obrigatórios. Expressão String 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

String[,]

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

O uso do recurso My oferece melhor produtividade e desempenho em operações do Registro do que o GetAllSettings. Para obter mais informações, consulte Registry.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentException

O usuário não está conectado.

Exemplos

Este exemplo primeiro usa a SaveSetting função para fazer entradas no Registro do Windows para o aplicativo especificado como AppName, em seguida, usa a GetAllSettings função 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 ou AppNameSection não existir.

Como ele 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 do HKEY_LOCAL_MACHINE\Software\ registro ou HKEY_USER\DEFAULT\Software .

Confira também

• DeleteSetting(String, String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• Lendo e gravando a partir do Registro (Visual Basic)