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 den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit 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()