RollBack Property (MergeEvent object)

Microsoft Office InfoPath

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

expression.RollBack

expression    Required. An expression that returns a reference to a MergeEvent object.

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.

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.

Note  This object model member is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Service Pack 1 or later is not installed. Any form that implements this object model member in its code will generate an error message if it is opened in InfoPath when service pack features are disabled or unavailable.

Example

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

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