View.ForceUpdate-Methode
Erzwingt die Synchronisierung zwischen dem einem Formular zugrunde liegenden XML-Dokument und der zugeordneten Ansicht.
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()
Ausnahmen
Ausnahme | Bedingung |
---|---|
InvalidOperationException | Die ForceUpdate-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
Hinweise
Die Ansichten in einem Formular werden automatisch mit den Daten synchronisiert, die in dem einem Formular zugrunde liegenden XML-Dokument enthalten sind. Sie können die Synchronisierung jedoch mithilfe der ForceUpdate-Methode erzwingen. Dies kann hilfreich sein, wenn Daten in einer sekundären Datenquelle geändert wurden und somit in der Ansicht aktualisiert werden müssen.
Die automatische Synchronisierung kann mithilfe der DisableAutoUpdate-Methode deaktiviert und mithilfe der EnableAutoUpdate-Methode aktiviert werden.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die ForceUpdate-Methode der View-Klasse verwendet, um die Synchronisierung zwischen dem dem Formular zugrunde liegenden XML-Dokument und der aktuellen Ansicht zu erzwingen.
this.CurrentView.ForceUpdate();
Me.CurrentView.ForceUpdate()