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 表达式,包含删除的键设置的名称。
异常
异常类型 |
错误号 |
条件 |
---|---|---|
Section、AppName 或 Key 设置不存在。 |
||
用户没有登录。 |
如果正在升级使用非结构化错误处理方式的 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")
智能设备开发人员说明
不支持此函数。
要求
模块:Interaction
程序集:Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)