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

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

从 Windows 注册表中某个应用程序的项中删除一个节或一个项设置。 与 DeleteSetting 函数相比，My 功能在注册表操作方面可为你提供更高的效率和更好的性能。 有关更多信息，请参见Registry。

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void DeleteSetting (string AppName, string? Section = default, string? Key = default);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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 表达式，包含要删除的项设置的名称。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

用户没有登录。

示例

以下示例首先使用 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。

另请参阅

• GetAllSettings(String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException