Interaction.DeleteSetting(String, String, String) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Interaction.vb

Quelle:: Interaction.vb

Quelle:: Interaction.vb

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 -> 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: SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

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: