Interaction.DeleteSetting(String, String, String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从 Windows 注册表中某个应用程序的项中删除一个节或一个项设置。 与 DeleteSetting
函数相比,My
功能在注册表操作方面可为你提供更高的效率和更好的性能。 有关更多信息,请参见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)
参数
- AppName
- String
必需。 String
表达式,包含应用节或项设置的应用程序或项目的名称。
- Section
- String
必需。 String
表达式,包含要从中删除项设置的节的名称。 如果仅提供了 AppName
和 Section
,则将删除指定的节以及所有相关的项设置。
- Key
- String
可选。 String
表达式,包含要删除的项设置的名称。
- 属性
例外
用户没有登录。
示例
以下示例首先使用 SaveSetting
过程在 Windows 注册表中为 MyApp
应用程序创建条目,然后使用 DeleteSetting
函数将其删除。 由于未指定参数 Key
,因此将删除整个 Startup
节,包括节名及其所有键。
' 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")
注解
如果提供了所有参数,则删除指定的设置。 如果尝试对不存在的节或键设置使用 DeleteSetting
,则会出现运行时错误。
DeleteSetting
要求用户登录,因为它在注册表项下 HKEY_LOCAL_USER
运行,在用户以交互方式登录之前,注册表项不会处于活动状态。
要从非交互式进程 ((如 Mtx.exe) )访问的注册表设置应存储在 或 注册表项下HKEY_LOCAL_MACHINE\Software\
HKEY_USER\DEFAULT\Software
。