RelationshipCol Remove Method

See Also

This method deletes a relationship from its relationship collection. The exact behavior of this method depends on whether the relationship collection is an origin collection or a destination collection.

If the relationship collection is an origin collection, this method deletes the versioned relationship.

If the relationship collection is a destination collection, this method first performs object-version resolution to yield a single target-object version, and then it removes that target-object version from the relationship's TargetVersions collection.

Syntax

Call object.Remove( index )
Call object.Remove( objName )

The Remove method syntax has the following parts.

Part Description
object The relationship collection.
index The index of the relationship to be removed from the collection.
objName The relationship that uses this name for its destination object is to be removed from the collection.

Remarks

A relationship can be removed by name only if it is a unique-naming relationship.

If the source is the origin, the origin version must be unfrozen.

If the relationship is a destination relationship and the resolution strategy yields a target object version that is frozen, this method fails.