XmlEvent.Changed-Ereignis
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
'Declaration
Public MustOverride Event Changed As XmlChangedEventHandler
'Usage
Dim instance As XmlEvent
Dim handler As XmlChangedEventHandler
AddHandler instance.Changed, handler
public abstract event XmlChangedEventHandler Changed
Ausnahmen
| Ausnahme | 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 InfoPath 2010 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 InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
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