DeleteSetting 函数

更新:2007 年 11 月

从 Windows 注册表的应用程序项中删除节或项设置。

在注册表操作中,My 功能具有比 DeleteSetting 函数更高的效率和更好的性能。有关更多信息,请参见 My.Computer.Registry 对象

Public Sub DeleteSetting( _
   ByVal AppName As String, _
   Optional ByVal Section As String = Nothing, _
   Optional ByVal Key As String = Nothing _
)

参数

  • AppName
    必选。String 表达式,包含节或键设置应用到的应用程序或项目的名称。

  • Section
    必选。String 表达式,包含要从中删除键设置的节的名称。如果只给出 AppName 和 Section,则指定的节连同所有相关的键设置都会被删除。

  • Key
    可选。String 表达式,包含删除的键设置的名称。

异常

异常类型

错误号

条件

ArgumentException

5

Section、AppName 或 Key 设置不存在。

ArgumentException

5

用户没有登录。

如果正在升级使用非结构化错误处理方式的 Visual Basic 6.0 应用程序,请参见“错误号”一列。(您可以根据 Number 属性(Err 对象) 比较错误号。) 然而,如果可能,应当考虑用 Visual Basic 的结构化异常处理概述 替换这种错误控制。

备注

如果提供了所有参数,则删除指定的设置。如果试图使用 DeleteSetting 删除一个不存在的节或键设置,则发生运行时错误。

DeleteSetting 要求用户必须登录,因为它在 HKEY_LOCAL_USER 注册表项下操作,而该注册表项只有在用户交互登录以后才激活。

要从非交互式进程(例如 Mtx.exe)访问的注册表设置应存储在 HKEY_LOCAL_MACHINE\Software\ 或 HKEY_USER\DEFAULT\Software 注册表项下。

示例

下面的示例首先使用 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")

智能设备开发人员说明

不支持此函数。

要求

命名空间:Microsoft.VisualBasic

模块:Interaction

程序集:Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)

请参见

参考

GetAllSettings 函数

GetSetting 函数

SaveSetting 函数

ArgumentException