View.DisableAutoUpdate method
Disables automatic synchronization between a form's underlying XML document and the associated view.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub DisableAutoUpdate
'Usage
Dim instance As View
instance.DisableAutoUpdate()
public abstract void DisableAutoUpdate()
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | The DisableAutoUpdate method was called from an event handler for the Loading event. |
Remarks
The views in a 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.
This member 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.
This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.
Examples
In the following example, the DisableAutoUpdate method of the View class is used to disable synchronization between a form's underlying XML document and the view that it is associated with.
this.CurrentView.DisableAutoUpdate();
Me.CurrentView.DisableAutoUpdate()