VB.NET Language in a Nutshell, Second Edition

Name

GetSetting Function

Class

Microsoft.VisualBasic.Interaction

Syntax

GetSetting(appname, section, key[, default])

appname (required; String)

The name of the application

section (required; String)

The path from the application key to the key containing the value entries

key (required; String)

The name of the value entry whose value is to be returned

default (optional; String)

The value to return if no value can be found

Return Value

A string containing the value of the specified key; default if key, section, or appname were not found.

Description

Returns a single value from a specified section of your application’s entry in the HKEY_CURRENT_USER\Software\VB and VBA Program Settings\ branch of the registry.

Rules at a Glance

• If at least one of appname, section, or key is not found in the registry, GetSetting returns default.

• If default is omitted, it is assumed to be a zero-length string (“”).

• The function retrieves a value from a subkey of the KEY_CURRENT_USER\Software\VB and VBA Program Settings key of the registry.

• section need not be an immediate subkey of appname; instead, section can be a fully qualified path to a nested subkey, with each subkey separated from its parent by a backslash. For example, a value of Settings\Coordinates for the section argument indicates that the value is to be retrieved from HKEY_CURRENT_USER\Software\VB and VBA Program Settings\appname\Settings\Coordinates.

Programming Tips and Gotchas

• GetSetting is a function that was developed to retrieve data from ...