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
Requirements for Changing an Object-Version