Interaction.DeleteSetting(String, String, String) Metoda
Definice
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í 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.