View.ForceUpdate Method

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

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

public:
 abstract void ForceUpdate();

public abstract void ForceUpdate ();

abstract member ForceUpdate : unit -> unit

Public MustOverride Sub ForceUpdate ()

Exceptions

InvalidOperationException

The ForceUpdate method was called from an event handler for the Loading event.

Examples

In the following example, the ForceUpdate method of the View class is used to force synchronization between the form's underlying XML document and the current view.

this.CurrentView.ForceUpdate(); Me.CurrentView.ForceUpdate()

Remarks

The views in a 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.

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.