Share via


View.ForceUpdate Method (Microsoft.Office.InfoPath)

Forces 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 ForceUpdate
'Usage
Dim instance As View

instance.ForceUpdate
public abstract void ForceUpdate ()

Exceptions

Exception type Condition

InvalidOperationException

The ForceUpdate 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. 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 Office InfoPath 2007.

Example

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()

See Also

Reference

View Class
View Members
Microsoft.Office.InfoPath Namespace