Sdílet prostřednictvím


Interaction.DeleteSetting(String, String, String) Metoda

Definice

Odstraní oddíl nebo nastavení klíče z položky aplikace v registru systému Windows. Tato My funkce poskytuje vyšší produktivitu a výkon při operacích registru než DeleteSetting funkce . Další informace najdete 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

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

Section
String

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

Key
String

Nepovinný parametr. String výraz obsahující název nastavení klíče, který se odstraňuje.

Atributy

Výjimky

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

Příklady

Následující příklad nejprve použije proceduru SaveSetting k vytvoření položek v registru systému Windows pro MyApp aplikaci a poté použije DeleteSetting funkci k jejich odebrání. Protože není zadán žádný Key argument, je odstraněn celý Startup oddíl, 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í. Při pokusu o použití DeleteSetting v neexistující části nebo nastavení klíče dojde k chybě za běhu.

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

Nastavení registru, ke kterým se má přistupovat z neinteraktivních procesů (například Mtx.exe), by měla být uložená pod HKEY_LOCAL_MACHINE\Software\ klíči registru nebo HKEY_USER\DEFAULT\Software .

Platí pro

Viz také