Add (clsCollection)
Note
This feature will be removed in the next version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible.
The Add method of a Decision Support Objects (DSO) collection adds an object to the collection. This method does not apply to CustomProperties collections.
Note
It is recommended that you use the AddNew method when adding new objects. You should use the Add method only when adding existing objects: for example, when you are adding aggregations to a partition after you have designed them. For more information, see clsPartitionAnalyzer.
Syntax
object.Add(obj, [sKey As String], [Before])
Parameters
- object
An instance of a DSO collection object.
- obj
An instance of a DSO object.
- sKey
(Reserved) Defaults to Item.Name. If specified, it must contain the value of the item's Name property.
Before
(Optional) An expression that specifies a relative position in the collection. The member to be added is placed in the collection before the member identified by the Before argument. The value of Before must be a number from 1 to the value of the colCollection.Count property. If you omit this parameter, the item is appended at the last position in the collection. This argument is ignored if the collection is sorted; the member to be added is placed in the position indicated by the sort order of the collection.Note
All collections in the DSO object model are one-based. That is, the first item in the collection has an index of 1 and the last item has an index equal to the value of the Count property.