Interaction.DeleteSetting(String, String, String) 方法

定义

从 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 表达式,包含要从中删除项设置的节的名称。 如果仅提供了 AppNameSection,则将删除指定的节以及所有相关的项设置。

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

适用于

另请参阅