View.DisableAutoUpdate-Methode
Deaktiviert die automatische 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 DisableAutoUpdate
'Usage
Dim instance As View
instance.DisableAutoUpdate()
public abstract void DisableAutoUpdate()
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die DisableAutoUpdate-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 dem Formular zugrunde liegenden XML-Dokument enthalten sind. Sie können diesen Vorgang mithilfe der DisableAutoUpdate-Methode außer Kraft setzen. Dies kann aus Leistungsgründen erforderlich sein, wenn Sie z. B. zahlreiche Änderungen an dem einem Formular zugrunde liegenden XML-Dokument programmgesteuert vornehmen und nicht möchten, dass die Ansicht aktualisiert wird, bevor sämtliche Änderungen abgeschlossen wurden.
Standardmäßig werden Ansichten automatisch aktualisiert, wenn die Anwendung im Leerlauf ist. Die Synchronisierung der Ansicht kann mithilfe der EnableAutoUpdate-Methode erneut 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 DisableAutoUpdate-Methode der View-Klasse verwendet, um die Synchronisierung zwischen dem einem Formular zugrunde liegenden XML-Dokument und der dem Formular zugeordneten Ansicht zu deaktivieren:
this.CurrentView.DisableAutoUpdate();
Me.CurrentView.DisableAutoUpdate()