Edit

Share via


View.DisableAutoUpdate Method

Definition

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

public:
 void DisableAutoUpdate();
public void DisableAutoUpdate ();
abstract member DisableAutoUpdate : unit -> unit
Public Sub DisableAutoUpdate ()

Examples

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

thisXDocument.View.<span class="label">DisableAutoUpdate</span>();

Remarks

The views in a Microsoft Office InfoPath 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 programmatically 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.

By default, views will be updated automatically when the application is idle. View synchronization can be re-enabled using the EnableAutoUpdate() method.

Applies to