Selecting Items in a Collection

You can select the items of a collection by index, by sequence, by enumerator, or by name. If you get a collection for an origin object — that is, if you plan to move from an origin object to a destination object, all of these selection options are available. If you get a collection for a destination object — that is, if you plan to move from a destination object to an origin object, you have fewer selection options.

You can select collection items in the following ways:

• By index — choose the nth item in the collection, where n is a number between one and the size of the collection.

  COM: use the get_Item method of the IRelationshipCol interface or the ITargetObjectCol interface.

  Automation: use the syntax collection(index), as for any Automation collection.

• By sequence — Use the same programming statements to select by sequence as you use to select by index. The distinction between the two depends only on how the Repository orders the items in the collection. In most cases, the Repository uses an arbitrary order. But if the collection is a sequenced collection, the Repository orders the collection items according to the defined sequence.

  You can select by sequence only from a collection belonging to an origin object. You cannot select by sequence from a collection belonging to a destination object, because the Repository does not sequence collections belonging to destination objects.

• With an enumerator — That is, at the COM level you can get an enumerator object for a collection, and then use the standard enumerator functions (Next, Skip, Reset, and Clone). Use the _NewEnum method of the IRelationshipCol interface or the ITargetObjectCol interface to obtain an interface pointer to an enumerator object.

  For More Information   Using Enumerators with the Repository

• By name — If the collection is a naming collection, you can select the item whose name matches the name you supply.

  COM: use the get_Item method of the IRelationshipCol interface or the ITargetObjectCol interface.

  Automation: use the syntax myCollection("name").

  Note   You cannot select by name from a collection belonging to a destination object, because the Repository does not support the naming of origin objects.

  If the naming collection is not a unique-naming collection, and there are multiple items with the same name, the Repository will return the first item that it finds with the specified name.