GetSetting-Funktion

Artikel
09/03/2008

Aktualisiert: November 2007

Gibt einen Wert für eine Schlüsseleinstellung aus einem Anwendungseintrag in der Windows-Registrierung 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 GetSetting( _
   ByVal AppName As String, _
   ByVal Section As String, _
   ByVal Key As String, _
   Optional ByVal Default As String = "" _
) As String

Parameter

AppName
Erforderlich. String-Ausdruck mit dem Namen der Anwendung oder des Projekts, deren bzw. dessen Schlüsseleinstellung angefordert wird.
Section
Erforderlich. String-Ausdruck mit dem Namen des Abschnitts, in dem sich die Schlüsseleinstellung befindet.
Key
Erforderlich. String-Ausdruck mit dem Namen der zurückzugebenden Schlüsseleinstellung.
Default
Optional. Ausdruck mit dem Wert, der zurückgegeben werden soll, wenn in der Key-Einstellung kein Wert festgelegt ist. Erfolgt keine Angabe, wird für Default eine Zeichenfolge mit der Länge 0 (null, "") angenommen.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Mindestens ein Argument ist kein String-Ausdruck, oder der 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 Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Wenn eines der in den GetSetting-Argumenten angegebenen Elemente nicht vorhanden ist, gibt GetSetting den Wert von Default zurück.

Für GetSetting 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.

Für GetSetting ist die Read-Registrierungsberechtigung erforderlich.

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 wird mithilfe der GetSetting-Funktion eine der Einstellungen angezeigt. Da das Default-Argument angegeben wurde, wird in jedem Fall ein Wert zurückgegeben. Beachten Sie, dass Section-Namen nicht mit GetSetting abgerufen werden können. Am Ende werden alle Einträge der Anwendung durch die DeleteSetting-Funktion entfernt.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
DeleteSetting("MyApp")