Freigeben über


Interaction.DeleteSetting(String, String, String) Methode

Definition

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 -> unit
static member DeleteSetting : string * string * string -> unit
Public 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.

Gilt für:

Weitere Informationen