GetAllSettings-Funktion

Artikel
09/03/2008

Aktualisiert: November 2007

Gibt eine Liste der Schlüsseleinstellungen eines Anwendungseintrags in der Windows-Registrierung mit ihren jeweiligen Werten (ursprünglich mit SaveSetting erstellt) zurück.

Das My-Feature ermöglicht bei Registrierungsoperationen höhere Produktivität und Leistung als GetAllSettings. Weitere Informationen hierzu finden Sie unter My.Computer.Registry-Objekt.

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

Parameter

AppName
Erforderlich. String-Ausdruck mit dem Namen der Anwendung oder des Projekts, deren bzw. dessen Schlüsseleinstellungen angefordert werden.
Section
Erforderlich. String-Ausdruck mit dem Namen des Abschnitts, dessen Schlüsseleinstellungen angefordert werden. GetAllSettings gibt ein Objekt zurück, das ein zweidimensionales Array von Zeichenfolgen enthält. Die Zeichenfolgen beinhalten alle Schlüsseleinstellungen im angegebenen Abschnitt sowie deren jeweiligen Werte.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Benutzer ist nicht angemeldet.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlerkontrolle durch Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

GetAllSettings gibt ein nicht initialisiertes Object zurück, wenn AppName oder Section nicht vorhanden ist.

Für GetAllSettings muss ein Benutzer angemeldet sein, da diese Funktion unter dem HKEY_LOCAL_USER-Registrierungsschlüssel ausgeführt wird und dieser Schlüssel erst aktiviert ist, nachdem sich ein Benutzer interaktiv angemeldet hat.

Die Registrierungseinstellungen, auf die über einen nicht interaktiven Prozess zugegriffen werden kann (z. B. Mtx.exe), sollten entweder unter dem HKEY_LOCAL_MACHINE\Software\-Registrierungsschlüssel oder unter dem HKEY_USER\DEFAULT\Software-Registrierungsschlüssel gespeichert werden.

Beispiel

Im folgenden Beispiel wird erst die SaveSetting-Funktion verwendet, um für die mit AppName angegebene Anwendung in der Windows-Registrierung Einträge vorzunehmen. Anschließend werden die Einstellungen mithilfe der GetAllSettings-Funktion angezeigt. Beachten Sie, dass Anwendungsnamen und Section-Namen nicht mit GetAllSettings abgerufen werden können. Am Ende werden die Einträge der Anwendung durch die DeleteSetting-Funktion entfernt.

' 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")