Visual Basic: RDO Data Control

BatchCollisionRows Property

See Also    Example    Applies To

Returns an array of bookmarks indicating the rows that generated collisions in the last batch update operation.

Syntax

object**.BatchCollisionRows**

The object placeholder represents an object expression that evaluates to an object in the Applies To list.

Return Values

The BatchCollisionRows property return value is a Variant(string) expression as described in Remarks.

Remarks

This property contains an array of bookmarks to rows that encountered a collision during the last invocation of the BatchUpdate method. The number of elements in the array is indicated by the BatchCollisionCount property.

By setting the working rdoResultset object's Bookmark property to bookmark values in the BatchCollisionRows array, you can position to each row that failed to complete the most recent BatchUpdate operation.

After the collision rows are corrected, the BatchUpdate method can be called again. At this point RDO attempts another batch update, and the BatchCollisionRows property again reflects the set of rows that failed the second attempt. Any rows that succeeded in the previous attempt are not sent in the current attempt, as they now have a Status of rdRowUnmodified. This process can continue as long as collisions occur, or until you abandon the updates and close the result set.

This array is re-created each time the BatchUpdate method executes.