VersionedRelationship Delete Method

Meta Data Services Programming

Meta Data Services Programming

VersionedRelationship Delete Method

This method deletes a relationship from its relationship collection.

This method is not attached to the default interface for the repository Automation object; it is attached to the IRepositoryItem interface. For more information about accessing a member of an interface that is not the default interface, see Accessing Automation Object Members.

Syntax

Call object.Delete

The Delete method syntax has the following part.

Part Description
object An object expression that evaluates to a VersionedRelationship object
Remarks

If the item to be deleted is an origin versioned relationship, this method fails unless the source object version satisfies the basic requirements for changing an object version. Assuming the source object version can be changed, the repository engine deletes the entire relationship (rather than merely removing one item from the TargetVersions collection of the relationship). In other words, after this method finishes, no version of the destination object remains related to the origin object version. Furthermore, if the relationship is a delete-propagating relationship, the repository engine considers performing one or more propagated deletions.

If the item to be deleted is a destination versioned relationship, the repository engine follows a resolution strategy to yield a single origin object version from the TargetVersions collection of the relationship. If that origin object version cannot be changed (that is, if it does not satisfy the requirements for changing an object version), this method fails. Assuming that the origin object version can be changed, the repository engine removes it from the TargetVersions collection of the relationship. Furthermore, if the relationship is a delete-propagating relationship, the repository engine considers performing one or more propagated deletions.

For more information, see Propagating Deletes.

See Also

IRepositoryItem Interface

Relationship Object

Requirements for Changing an Object-Version

Resolution Strategy for Objects and Object Versions

VersionedRelationship Object