View.ForceUpdate method
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 | 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 InfoPath Filler.
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()