2022.2

Methods
Name
Return
type
Description
"Add(const String Name, const String Value)" below Adds a new element to the collection or overwrites its value.
"Add2(const String Name, const String Value, TAd-
dFlags Flags, Integer Index (optional))" on the facing
page
Adds a new element with a customizable behavior if the name already exists.
Note that the TAddFlags type is not defined in an Active Script environment,
such as the Run Script task. See the detailed reference for the numerical values
to use.
Clear() Deletes all the elements of the collection.
"CountByName(const String Name)" on the facing
page
Integer Returns the number of elements with the specified name.
"Delete(Integer Index)" on page188 Deletes the element at the specified index.
"Item(Integer Index)" on page188 String Returns the value of the element stored at the specified index.
"ItemByName(const String Name)" on page188 String Returns the value of the element of the specified name.
"ItemByNameIndex(const String Name, Integer
Index)" on page189
String Returns the value of the n'th element of the specified name.
"Name(Integer Index)" on page189 String Returns the name of the element stored at the specified index.
Attributes and Fields methods
This topic lists the methods of the "Attributes" on page184 and "Fields" on the previous page collection
container objects.
Note that the Add2() and the ItemByNameIndex() functions are only available with Fields. Fields
support multiple entries with the same name, which is forbidden with Attributes.
Add(const String Name, const String Value)
Adds a new element to the collection. If the specified name already exists in the collection, the new
value overwrites the previous one.
Parameters
Name
Name of the element to add. The name must adhere to this syntax rules: start with a letter, followed
by zero or more letters, numbers, underscore or dash. The name is not case-sensitive.
Value
Value of the element. There is no restriction on the content, although binary is discouraged.
Exceptions
l
EOleException The name is empty or invalid.
Page 186