Interaction.DeleteSetting(String, String, String) Metoda

Definice

Odstraní nastavení oddílu nebo klíče ze položky aplikace v registru Windows. Tato My funkce poskytuje vyšší produktivitu a výkon v operacích registru než funkce DeleteSetting . Další informace naleznete v tématu 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

Required. String výraz obsahující název aplikace nebo projektu, na který se vztahuje nastavení oddílu nebo klíče.

Section
String

Required. String výraz obsahující název oddílu, ze kterého se odstraňuje nastavení klíče. Pokud jsou k dispozici pouze AppName a Section jsou k dispozici, zadaný oddíl se odstraní spolu se všemi souvisejícími nastaveními klíče.

Key
String

Optional. String výraz obsahující název odstraněného nastavení klíče.

Atributy

Výjimky

Uživatel není přihlášen.

Příklady

Následující příklad nejprve používá proceduru SaveSetting k provedení položek v registru Windows pro aplikaci MyApp a potom pomocí funkce DeleteSetting je odebrat. Protože není zadán žádný Key argument, Startup celý oddíl se odstraní, včetně názvu oddílu a všech jeho klíčů.

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

Poznámky

Pokud jsou zadány všechny argumenty, zadané nastavení se odstraní. K chybě za běhu dojde, pokud se pokusíte použít DeleteSetting v neexistující části nebo nastavení klíče.

DeleteSetting vyžaduje, aby byl uživatel přihlášen, protože pracuje pod HKEY_LOCAL_USER klíčem registru, který není aktivní, dokud se uživatel neaktivuje interaktivně.

Nastavení registru, ke kterým se má přistupovat z neinteraktivního procesu (například Mtx.exe), by se měla ukládat v klíčích HKEY_LOCAL_MACHINE\Software\ registru nebo v klíčích HKEY_USER\DEFAULT\Software registru.

Platí pro

Viz také