Freigeben über


XmlEvents Klasse

Definition

Die Auflistung aller XmlEvent Ereignisse für eine Formularvorlage.

public ref class XmlEvents abstract
public abstract class XmlEvents
type XmlEvents = class
Public MustInherit Class XmlEvents
Vererbung
XmlEvents

Beispiele

Das folgende Beispiel zeigt Code, der von InfoPath in der InternalStartup-Methode generiert wird, um den Ereignishandler für ein Validating Ereignis zu binden, das einem Feld im dem Formular zugrunde liegenden XML-Dokument zugeordnet ist, indem die Item[String] -Eigenschaft der XmlEvents-Klasse verwendet wird. Außerdem wird der Code angezeigt, der für das Changed-Ereignis eines Felds generiert wird, das mithilfe der -Eigenschaft der XmlEvents-Klasse an die Item[String, String]CategoryName-Spalte einer sekundären Datenquelle namens Categories gebunden ist.

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

Hinweise

Die XmlEvents-Auflistung und die XmlEvent-Klasse werden verwendet, um ein Ereignis auf Dokumentebene (z. B. das Changed Ereignis für ein Feld oder eine Gruppe im einem Formular zugrunde liegenden XML-Dokument) an einen Ereignishandler in der InternalStartup-Methode am Anfang der FormCode-Klasse in einer Formularvorlage mit verwaltetem Code zu binden. 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 darin enthaltenen Ereignisbindungscode 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.

Konstruktoren

XmlEvents()

Die Auflistung aller XmlEvent Ereignisse für eine Formularvorlage.

Eigenschaften

Item[String, String]

Ruft einen XmlEvent aus der XmlEvents Auflistung zum Binden eines Ereignishandlers ab, indem der XPath des zugrunde liegenden XML-Dokumentknotens angegeben wird, der das Ereignis auslösen kann, und den Namen der sekundären Datenquelle, die die Daten bereitstellt.

Item[String]

Ruft einen XmlEvent aus der XmlEvents Auflistung zum Binden eines Ereignishandlers ab, indem der XPath des zugrunde liegenden XML-Dokumentknotens angegeben wird, der das Ereignis auslösen kann.

Gilt für: