SaveSetting-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Speichert oder erstellt einen Anwendungseintrag in der Windows-Registrierung.

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

Public Sub SaveSetting( _
   ByVal AppName As String, _ 
   ByVal Section As String, _
   ByVal Key As String, _
   ByVal Setting As String _
)

Parameter

AppName
Erforderlich. String-Ausdruck mit dem Namen der Anwendung oder des Projekts, für die bzw. das die Einstellung gilt.
Section
Erforderlich. String-Ausdruck mit dem Namen des Abschnitts, in dem die Schlüsseleinstellung gespeichert wird.
Key
Erforderlich. String-Ausdruck mit dem Namen der Schlüsseleinstellung, die gespeichert wird.
Setting
Erforderlich. Ausdruck mit dem Wert, auf den Key festgelegt wird.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Schlüsselregistrierung konnte nicht erstellt werden, oder 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

Die SaveSetting-Funktion fügt den Schlüssel zu HKEY_CURRENT_USER\Software\VB and VBA Program Settings hinzu.

Wenn die Schlüsseleinstellung aus irgendeinem Grund nicht gespeichert werden kann, tritt ein Fehler auf.

Für SaveSetting muss ein Benutzer angemeldet sein, da es 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.

SaveSetting erfordert die RegistrierungsberechtigungenWrite und Create.

Beispiel

Im folgenden Beispiel wird erst die SaveSetting-Funktion verwendet, um für die MyApp-Anwendung in der Windows-Registrierung Einträge vorzunehmen. Anschließend werden diese Einträge mithilfe der DeleteSetting-Funktion entfernt.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")