Interaction.DeleteSetting(String, String, String) Metoda

Reference

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Zdroj:: Interaction.vb

Zdroj:: Interaction.vb

Zdroj:: Interaction.vb

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Výjimky

ArgumentException

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