Udostępnij za pośrednictwem


Interaction.DeleteSetting(String, String, String) Metoda

Definicja

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

Wyjątki

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ż