VB.NET Language in a Nutshell, Second Edition

Name

DeleteSetting Procedure

Class

Microsoft.VisualBasic.Interaction

Syntax

DeleteSetting(appname[, section[, key]])

appname (required; String)

The name of the application. This must be a subkey of the HKEY_CURRENT_ USER\Software\VB and VBA Program Settings registry key.

section (optional; String)

The name of the application key’s subkey that is to be deleted. section can be a single key or a registry path separated with backslashes.

key (optional; String)

The name of the value entry to delete.

Description

Deletes a complete application key, one of its subkeys, or a single value entry from the Windows registry

Rules at a Glance

• section can contain a relative path (similar to that used to describe the folders on a hard drive) to navigate from the application key to the subkey to be deleted. For example, to delete the value entry named TestKey in the registry key HKEY_CURRENT_USER\Software\VB and VBA Program Settings\RegTester\BranchOne\BranchTwo, you would use:

  DeleteSetting "RegTester", "BranchOne\BranchTwo", _
                "TestKey"

• You cannot use DeleteSetting to delete entries from registry keys that are not subkeys of HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

• If key is supplied, only the value entry named key and its associated value are deleted.

• If key is omitted, the subkey named section is deleted.

• If section is omitted, the entire application key named appname is deleted.

Example

Sub TestTheReg( ) SaveSetting("MyRealGoodApp", _ "TestBranch\SomeSection\AnotherSection", _ "Testkey", ...