DeleteSetting-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Löscht einen Abschnitt oder eine Schlüsseleinstellung aus einem Anwendungseintrag in der Windows-Registrierung.

Das My-Feature ermöglicht bei Registrierungsoperationen höhere Produktivität und Leistungsfähigkeit als die DeleteSetting -Funktion. Weitere Informationen hierzu finden Sie unter My.Computer.Registry-Objekt.

Public Sub DeleteSetting( _
   ByVal AppName As String, _
   Optional ByVal Section As String = Nothing, _
   Optional ByVal Key As String = Nothing _
)

Parameter

AppName
Erforderlich. String-Ausdruck, der den Namen der Anwendung oder des Projekts enthält, auf die bzw. das sich der Abschnitt oder die Schlüsseleinstellung bezieht.
Section
Erforderlich. String-Ausdruck, der den Namen des Abschnitts enthält, aus dem die Schlüsseleinstellung gelöscht wird. Wenn nur AppName und Section angegeben werden, wird der angegebene Abschnitt gemeinsam mit allen verknüpften Schlüsseleinstellungen gelöscht.
Key
Optional. String-Ausdruck mit dem Namen der Schlüsseleinstellung, die gelöscht wird.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Die Einstellung Section, AppName oder Key ist nicht vorhanden.
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 Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Wenn alle Argumente angegeben werden, wird die angegebene Einstellung gelöscht. Ein Laufzeitfehler tritt auf, wenn Sie versuchen, die DeleteSetting-Anweisung auf einen nicht vorhandenen Abschnitt oder eine nicht vorhandene Schlüsseleinstellung anzuwenden.

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

Registrierungseinstellungen, auf die über einen nicht interaktiven Prozess (wie Mtx.exe) zugegriffen werden soll, müssen entweder unter dem HKEY_LOCAL_MACHINE\Software\-Registrierungsschlüssel oder dem HKEY_USER\DEFAULT\Software-Registrierungsschlüssel gespeichert werden.

Beispiel

Im folgenden Beispiel wird erst die SaveSetting-Prozedur 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. Da kein Key-Argument angegeben wurde, wird der gesamte Startup-Abschnitt, einschließlich des Abschnittsnamens und aller zugehörigen Schlüssel, gelöscht.

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