Item Property

Office VBScript

Microsoft® Visual Basic® Scripting Edition Item Property  Scripting Run-Time Reference 
Version 2 

See Also                    Applies To


Description
Sets or returns an item for a specified key in a Dictionary object. For collections, returns an item based on the specified key. Read/write.
Syntax
object.Item(key) [= newitem]

The Item property has the following parts:

Part Description
object Required. Always the name of a collection or Dictionary object.
key Required. Key associated with the item being retrieved or added.
newitem Optional. Used for Dictionary object only; no application for collections. If provided, newitem is the new value associated with the specified key.

Remarks
If key is not found when changing an item, a new key is created with the specified newitem. If key is not found when attempting to return an existing item, a new key is created and its corresponding item is left empty.

The following example illustrates the use of the Item property:

Function ItemDemo
  Dim d                   ' Create some variables.
  Set d = CreateObject("Scripting.Dictionary")
  d.Add "a", "Athens"     ' Add some keys and items.
  d.Add "b", "Belgrade"
  d.Add "c", "Cairo"
  ItemDemo = d.Item("c")  ' Get the item.         
End Function