Share via

MergeEvent.RollBack Property

  • Article
InfoPath Developer Reference

A read/write property that provides additional information to the OnMergeRequest event along with the ReturnStatus property flag. Read/write

Version Information
 Version Added:  InfoPath 2003

Syntax

expression.RollBack

expression   An expression that returns a MergeEvent object.

Return Value
Boolean

Remarks

If the ReturnStatus property of the MergeEvent object is set to True, this property is ignored.

If the ReturnStatus property is False and the RollBack property is True, the entire merging operation will be cancelled and rolled back to the state before the operation was initiated. If the RollBack property is False, merging the current form will fail, but the merging operation will continue with the next form.

Security Level 2: Can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

Example

In the following example, the RollBack property of the MergeEvent object is used to rollback the entire operation if a merge fails.

JScript 
  try
{
    XDocument.ImportDOM(eventObj.DOM)
}
catch (ex)
{
    eventObj.ReturnStatus = false;
    eventObj.RollBack = true;
}

See Also