Interaction.DeleteSetting(String, String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht einen Abschnitt oder eine Schlüsseleinstellung aus dem Eintrag einer Anwendung in der Windows-Registrierung. Das My Feature bietet Ihnen mehr Produktivität und Leistung in Registrierungsvorgängen als die DeleteSetting Funktion. Weitere Informationen finden Sie unter Registry.
public static void DeleteSetting(string AppName, string Section = default, string Key = default);static member DeleteSetting : string * string * string -> unitPublic Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)Parameter
- AppName
- String
Required.
String Ausdruck, der den Namen der Anwendung oder des Projekts enthält, auf die der Abschnitt oder die Schlüsseleinstellung angewendet wird.
- Section
- String
Required.
String Ausdruck, der den Namen des Abschnitts enthält, aus dem die Schlüsseleinstellung gelöscht wird. Wenn nur AppName und Section bereitgestellt wird, wird der angegebene Abschnitt zusammen mit allen zugehörigen Schlüsseleinstellungen gelöscht.
- Key
- String
Dies ist optional.
String Ausdruck, der den Namen der zu löschenden Schlüsseleinstellung enthält.
Ausnahmen
Der Benutzer ist nicht angemeldet.
Beispiele
Im folgenden Beispiel wird zunächst die SaveSetting-Prozedur verwendet, um Einträge in der Windows Registrierung für die Anwendung MyApp vorzunehmen, und anschließend wird die funktion DeleteSetting verwendet, um sie zu entfernen. Da kein Key Argument angegeben ist, wird der gesamte Startup Abschnitt gelöscht, einschließlich des Abschnittsnamens und aller zugehörigen Schlüssel.
' 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")
Hinweise
Wenn alle Argumente angegeben werden, wird die angegebene Einstellung gelöscht. Ein Laufzeitfehler tritt auf, wenn Sie versuchen, eine nicht vorhandene Abschnitts- oder Schlüsseleinstellung zu verwenden DeleteSetting .
DeleteSetting erfordert, dass ein Benutzer angemeldet ist, da er unter dem HKEY_LOCAL_USER Registrierungsschlüssel ausgeführt wird, der erst aktiv ist, wenn sich ein Benutzer interaktiv anmeldet.
Registrierungseinstellungen, auf die über einen nicht interaktiven Prozess (z. B. Mtx.exe) zugegriffen werden soll, sollten entweder unter den HKEY_LOCAL_MACHINE\Software\ Registrierungsschlüsseln oder unter den HKEY_USER\DEFAULT\Software Registrierungsschlüsseln gespeichert werden.