XmlEvent.Changed-Ereignis

Artikel
04/27/2010

Tritt ein, nachdem Änderungen an dem einem Formular zugrunde liegenden XML-Dokument angenommen und nachdem das Validating-Ereignis eingetreten ist.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

Public Event Changed As XmlChangedEventHandler

Dim instance As XmlEvent
Dim handler As XmlChangedEventHandler

AddHandler instance.Changed, handler

public abstract event XmlChangedEventHandler Changed

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Es wurde versucht, das Ereignis an einen anderen Speicherort als die InternalStartup-Methode zu binden.

Hinweise

Wichtig:
Das Changed-Ereignis sollte nicht im Formularcode instanziiert werden. Wenn Sie der Formularvorlage von der Entwurfsmodus-Benutzeroberfläche aus einen Ereignishandler hinzufügen, wird in Microsoft Office InfoPath 2007 mithilfe der EventManager-Klasse und mithilfe des Members der XmlEvent-Klasse in der InternalStartup-Methode der Formularcodedatei Code generiert, um Ereignisse auf Dokumentenebene an die zugehörigen Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

Das Changed-Ereignis sollte nicht im Formularcode instanziiert werden. Wenn Sie der Formularvorlage von der Entwurfsmodus-Benutzeroberfläche aus einen Ereignishandler hinzufügen, wird in Microsoft Office InfoPath 2007 mithilfe der EventManager-Klasse und mithilfe des Members der XmlEvent-Klasse in der InternalStartup-Methode der Formularcodedatei Code generiert, um Ereignisse auf Dokumentenebene an die zugehörigen Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

Die Bindung des Changed-Ereignisses erfolgt mithilfe des XmlChangedEventHandler-Delegaten.

Dieser Ereignishandler lässt nicht zu, dass Benutzer einen Vorgang abbrechen.

Das Change-Ereignis wird in der Regel zum Ändern von Formulardaten verwendet, nachdem andere Änderungen aufgetreten sind, z. B. um Berechnungen durchzuführen oder die Struktur des einem Formular zugrunde liegenden XML-Dokuments zu ändern.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird, nachdem für field9 eine Änderung vorgenommen und überprüft wurde, für field4 ein Wert hinzugefügt, um diese Änderung wiederzugeben.

public void field9_Changed(object sender, XmlEventArgs e)
{
   this.CreateNavigator().SelectSingleNode("/my:myFields/my:field4", 
      this.NamespaceManager).SetValue("Field9 was changed.");
}

Public Sub field9_Changed(ByVal sender As Object, _
   ByVal e As XmlEventArgs )
   Me.CreateNavigator().SelectSingleNode("/my:myFields/my:field4", _
      Me.NamespaceManager).SetValue("Field9 was changed.")
End Sub

Siehe auch

Referenz

XmlEvent-Klasse
XmlEvent-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über