Freigeben über


XmlEvents-Klasse

Die Auflistung aller XmlEvent-Ereignisse für eine Formularvorlage.

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

Syntax

'Declaration
<DefaultMemberAttribute("Item")> _
Public MustInherit Class XmlEvents
'Usage
Dim instance As XmlEvents
[DefaultMemberAttribute("Item")] 
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.

Beispiel

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

Vererbungshierarchie

System.Object
  Microsoft.Office.InfoPath.XmlEvents

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

XmlEvents-Member
Microsoft.Office.InfoPath-Namespace