Microsoft® Visual Basic® Scripting Edition Item Property | Language 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

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.