DisableAutoUpdate Method

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

expression.DisableAutoUpdate()

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. You can override this by using the DisableAutoUpdate method. You may need to do this for performance reasons, such as when you are programatically making many changes to a form's underlying XML document and you do not want the view to be refreshed until the changes are complete.

Automatic synchronization can be enabled using the EnableAutoUpdate method of the View object.

Example

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

    XDocument.View.DisableAutoUpdate();