Udostępnij za pośrednictwem

Interaction.DeleteSetting(String, String, String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.Core.dll
Zestaw:
Microsoft.VisualBasic.dll
Źródło:
Interaction.vb
Źródło:
Interaction.vb
Źródło:
Interaction.vb

Usuwa ustawienie sekcji lub klucza z wpisu aplikacji w rejestrze systemu Windows. Funkcja My zapewnia większą produktywność i wydajność operacji rejestru niż DeleteSetting funkcja. Aby uzyskać więcej informacji, zobacz 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)

Parametry

AppName
String

Wymagane. String wyrażenie zawierające nazwę aplikacji lub projektu, do którego ma zastosowanie sekcja lub ustawienie klucza.

Section
String

Wymagane. String wyrażenie zawierające nazwę sekcji, z której jest usuwane ustawienie klucza. Jeśli jest dostępna tylko AppName i Section podana, określona sekcja zostanie usunięta wraz ze wszystkimi powiązanymi ustawieniami klucza.

Key
String

Opcjonalny. String wyrażenie zawierające nazwę usuniętego ustawienia klucza.

Atrybuty
SupportedOSPlatformAttribute

Wyjątki

ArgumentException

Użytkownik nie jest zalogowany.

Przykłady

W poniższym przykładzie najpierw użyto procedury w SaveSetting celu wpisów w rejestrze systemu Windows dla MyApp aplikacji, a następnie użyto DeleteSetting funkcji do ich usunięcia. Ponieważ nie określono żadnego Key argumentu, cała Startup sekcja jest usuwana, łącznie z nazwą sekcji i wszystkimi jego kluczami.

' 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")

Uwagi

Jeśli podano wszystkie argumenty, określone ustawienie zostanie usunięte. Błąd czasu wykonywania występuje, jeśli próbujesz użyć DeleteSetting w nieistniejących sekcjach lub ustawieniach klucza.

DeleteSetting wymaga zalogowania użytkownika, ponieważ działa on w ramach HKEY_LOCAL_USER klucza rejestru, który nie jest aktywny, dopóki użytkownik nie zaloguje się interaktywnie.

Ustawienia rejestru, które mają być dostępne z nieinterakcyjnego procesu (na przykład Mtx.exe), powinny być przechowywane w ramach HKEY_LOCAL_MACHINE\Software\ kluczy rejestru lub HKEY_USER\DEFAULT\Software .

Dotyczy

Zobacz też