ForceUpdate Method

Microsoft Office InfoPath

Show All Show All

ForceUpdate Method

Forces synchronization between a form's underlying XML document and the associated View object.

expression.ForceUpdate()

expression    Required. An expression that returns a reference to the View 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

The views in a Microsoft Office InfoPath 2003 form are automatically synchronized with the data that is contained in a form's underlying XML document. However, you can force synchronization to occur using the ForceUpdate method. This is also useful when data in a secondary data source has changed and needs to be refreshed in the view.

Automatic synchronization can be disabled using the DisableAutoUpdate method and enabled using the EnableAutoUpdate method.

Example

In the following example, the ForceUpdate method of the View object is used to force synchronization between a form's underlying XML document and the view that it is associated with:

    XDocument.View.ForceUpdate();