Sets existing or adds a new item to the collection.
In difference to the Add
method Set method issues an error if the operation fails.Syntax:
object.Set(key_name,item)
IDL definition:
[id(10), helpstring("method Set")] HRESULT Set([in]
VARIANT VarKey,[in] VARIANT VarItem,[out,retval] VARIANT* pvarPlace);
Parameters:
object - Previously created VarDictionary object
key_name - expression that can be converted to a string. It becomes
the name of the new item.
item - item to set
If the key_name is a string and the name already exists in the collection
then the first item with that name will be set to the new value passed
in the item parameter. If the key_name is a string, but it is not
used in the collection - then new item will be created with the given
(by key_name) name.
If the key_name is a number - it will be treated as an item
index. If the item on that index exists it will be set to the new value
passed through the item parameter. If the index is out of the
current range/not corresponds to an existing item in the collection
operation will fail with an error.
Examples:
var item = "My Item";
vardict.Set("Item 3",item);
Dim item
Set item = Server.CreateObject("ADODB.Connection")
vardict.Add("Item 3",item)
Remarks:
Set method does not depend on the itemsAssignmentAllowed
property - i.e. method can be used always in difference to
the put form of the Item property.
Applies to: VarDictionary
See also: Item property,
allowDuplicateNames, allowUnnamedValues
|