Interaction.DeleteSetting(String, String, String) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Egy szakasz- vagy kulcsbeállítást töröl egy alkalmazás bejegyzéséből a Windows beállításjegyzékben. A My funkció nagyobb hatékonyságot és teljesítményt biztosít a beállításjegyzék-műveletekben, mint a DeleteSetting függvény. További információ: 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 -> unitstatic member DeleteSetting : string * string * string -> unitPublic Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)Paraméterek
- AppName
- String
Kötelező.
String kifejezés, amely annak az alkalmazásnak vagy projektnek a nevét tartalmazza, amelyre a szakasz vagy a kulcsbeállítás vonatkozik.
- Section
- String
Kötelező.
String kifejezés, amely annak a szakasznak a nevét tartalmazza, amelyből a kulcsbeállítás törölve van. Ha csak AppName és Section meg van adva, a megadott szakasz az összes kapcsolódó kulcsbeállítással együtt törlődik.
- Key
- String
Optional.
String a törölt kulcsbeállítás nevét tartalmazó kifejezés.
- Attribútumok
Kivételek
A felhasználó nincs bejelentkezve.
Példák
Az alábbi példa először a SaveSetting eljárást használja a MyApp alkalmazás Windows beállításjegyzékében lévő bejegyzések létrehozásához, majd a DeleteSetting függvény használatával távolítja el őket. Mivel nincs Key megadva argumentum, a teljes Startup szakasz törlődik, beleértve a szakasz nevét és az összes kulcsát.
' 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")
Megjegyzések
Ha minden argumentum meg van adva, a megadott beállítás törlődik. Futásidejű hiba akkor fordul elő, ha nem létező szakaszon vagy kulcsbeállításon próbál meg használni DeleteSetting .
DeleteSetting megköveteli, hogy a felhasználó bejelentkezve legyen, mivel a HKEY_LOCAL_USER beállításkulcs alatt működik, amely nem aktív, amíg egy felhasználó nem jelentkezik be interaktívan.
A nem interaktív folyamatból (például Mtx.exe) elérni kívánt beállításjegyzék-beállításokat vagy a HKEY_LOCAL_MACHINE\Software\HKEY_USER\DEFAULT\Software beállításkulcsok alatt kell tárolni.
