XmlEvents-Klasse
Die Auflistung aller XmlEvent-Ereignisse für eine Formularvorlage.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.XmlEvents
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class XmlEvents
'Usage
Dim instance As XmlEvents
public abstract class XmlEvents
Hinweise
Die XmlEvents-Auflistung und die XmlEvent-Klasse dienen zum Binden eines Ereignisses auf Dokumentebene (z. B. das Changed-Ereignis für ein Feld oder eine Gruppe in einem dem Formular zugrunde liegenden XML-Dokument) an einen Ereignishandler in der InternalStartup-Methode am Anfang der FormCode-Klasse in einer verwalteten Codeformularvorlage. Zur Laufzeit wird die InternalStartup-Methode ausgeführt, wenn die Formularvorlage zum Initialisieren der Bindung aller Ereignishandler geöffnet wird.
Wichtig
Die InternalStartup-Methode und der Ereignisbindungscode darin werden von InfoPath generiert, wenn Sie Ereignishandler mithilfe verschiedener Benutzeroberflächenbefehle hinzufügen. Sie dürfen die InternalStartup-Methode nicht selbst erstellen oder zusätzlichen Code hinzufügen. Informationen zum Hinzufügen von Ereignishandlern mithilfe von Benutzeroberflächenbefehlen finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.
Beispiele
Im folgenden Beispiel wird Code generiert, der von InfoPath in der InternalStartup-Methode verwendet wird, um den Ereignishandler für ein Validating-Ereignis zu binden, das mit einem Feld im dem Formular zugrunde liegenden XML-Dokument verknüpft ist. Dabei wird die XmlEvents.Item[String]-Eigenschaft der XmlEvents-Klasse verwendet. Außerdem wird der Code generiert, der für das Changed-Ereignis eines Felds generiert wird, das an die CategoryName-Spalte (Kategoriename) einer sekundären Datenquelle namens Categories gebunden ist. Dabei wird die XmlEvents.Item[String, String]-Eigenschaft der XmlEvents-Klasse verwendet.
public void InternalStartup()
{
EventManager.XmlEvents["/my:myFields/my:field1"].Validating
+= new XmlChangedEventHandler(field1_Validating);
EventManager.XmlEvents[
"/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName",
"Categories"].Changed
+= new XmlChangedEventHandler(
Categories__CategoryName_attr_Changed);
}
Private Sub InternalStartup(ByVal sender As Object, _
ByVal e As EventArgs) Handles Me.Startup
AddHandler EventManager.XmlEvents( _
"/my:myFields/my:field1").Validating, _
AddressOf field2_Validating
AddHandler EventManager.XmlEvents( _
"/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName", _
"Categories").Changed, _
AddressOf Categories__CategoryName_attr_Changed
End Sub
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.