From http://www.w3schools.com (Copyright Refsnes Data)

ASP Dictionary Object

previous next

The Dictionary object is used to store information in name/value pairs (referred to as key and item)


Examples

Does a specified key exist?
This example demonstrates how to first create a Dictionary object, and then use the Exists method to check if a specified key exists.

Return an array of all items
This example demonstrates how to use the Items method to return an array of all the items.

Return an array of all keys
This example demonstrates how to use the Keys method to return an array of all the keys.

Return the value of an item
This example demonstrates how to use the Item property to return the value of an item.

Set a key
This example demonstrates how to use the Key property to set a key in a Dictionary object.

Return the number of key/item pairs
This example demonstrates how to use the Count property to return the number of key/item pairs.


The Dictionary Object

The Dictionary object is used to store information in name/value pairs (referred to as key and item). The Dictionary object might seem similar to Arrays, however, the Dictionary object is a more desirable solution to manipulate related data.

Comparing Dictionaries and Arrays:

The following example creates a Dictionary object, adds some key/item pairs to it, and retrieves the item value for the key gr:

<%
Dim d
Set d=Server.CreateObject("Scripting.Dictionary")
d.Add "re","Red"
d.Add "gr","Green"
d.Add "bl","Blue"
d.Add "pi","Pink"
Response.Write("The value of key gr is: " & d.Item("gr"))
%>

Output:

The value of key gr is: Green 

The Dictionary object's properties and methods are described below:

Properties

Property Description
CompareMode Sets or returns the comparison mode for comparing keys in a Dictionary object
Count Returns the number of key/item pairs in a Dictionary object
Item Sets or returns the value of an item in a Dictionary object
Key Sets a new key value for an existing key value in a Dictionary object

Methods

Method Description
Add Adds a new key/item pair to a Dictionary object
Exists Returns a Boolean value that indicates whether a specified key exists in the Dictionary object
Items Returns an array of all the items in a Dictionary object
Keys Returns an array of all the keys in a Dictionary object
Remove Removes one specified key/item pair from the Dictionary object
RemoveAll Removes all the key/item pairs in the Dictionary object


previous next

From http://www.w3schools.com (Copyright Refsnes Data)