VBScript in a Nutshell, 2nd Edition

Name

Dictionary.Exists Method

Syntax

                  dictionaryobject.Exists(key)

dictionaryobject

Use: Required

Data Type: Dictionary object

A reference to a Dictionary object.

key

Use: Required

Data Type: String

The key value being sought.

Return Value

Boolean

Description

Determines whether a given key is present in a Dictionary object.

Rules at a Glance

Returns True if the specified key exists in the Dictionary object; False if not.

Programming Tips and Gotchas

• If you attempt to use the Item property to return the item of a nonexistent key, or if you assign a new key to a nonexistent key, the nonexistent key is added to the dictionary, along with a blank item. To prevent this, you should use the Exists property to ensure that the Key is present in the dictionary before proceeding.

• The way in which key is compared with the existing key values is determined by the setting of the Dictionary object’s CompareMode property.

Example

If oDict.Exists(strOldKey) Then
    oDict.Key(strOldKey) = strNewKey
End If