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 einen Anwendungseintrag in der Windows-Registrierung. Das My-Feature bietet bei Registrierungsvorgängen höhere Produktivität und Leistung, als die DeleteSetting-Funktion. Weitere Informationen finden Sie unter Registry.
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void DeleteSetting (string AppName, string? Section = default, string? Key = default);public static void DeleteSetting (string AppName, string Section = default, string Key = default);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member DeleteSetting : string * string * string -> unitstatic member DeleteSetting : string * string * string -> unitPublic Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)Parameter
- AppName
- String
Erforderlich.
String-Ausdruck mit dem Namen der Anwendung oder des Projekts, für die bzw. das der Abschnitt oder die Schlüsseleinstellung gilt.
- Section
- String
Erforderlich.
String-Ausdruck mit dem Namen des Abschnitts, aus dem die Schlüsseleinstellung gelöscht wird. Wenn nur AppName und Section bereitgestellt werden, wird der angegebene Abschnitt mit allen zugehörigen Schlüsseleinstellungen gelöscht.
- Key
- String
Dies ist optional.
String-Ausdruck mit dem Namen der Schlüsseleinstellung, die gelöscht wird.
- Attribute
Ausnahmen
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 MyApp Anwendung vorzunehmen, und dann wird die DeleteSetting -Funktion verwendet, um sie zu entfernen. Da kein Key Argument angegeben wird, 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, für einen nicht vorhandenen Abschnitt oder eine Schlüsseleinstellung zu verwenden DeleteSetting .
DeleteSetting erfordert, dass ein Benutzer angemeldet ist, da er unter dem Registrierungsschlüssel ausgeführt wird, der HKEY_LOCAL_USER erst aktiv ist, wenn sich ein Benutzer interaktiv anmeldet.
Registrierungseinstellungen, auf die von einem nicht interaktiven Prozess (z. B. Mtx.exe) zugegriffen werden soll, sollten entweder unter oder unter den HKEY_LOCAL_MACHINE\Software\HKEY_USER\DEFAULT\Software Registrierungsschlüsseln gespeichert werden.
