DataDOMEventObject-Schnittstelle
Ein Ereignisobjekt, das während eines Datenüberprüfungsereignisses in Microsoft InfoPath verwendet wird.
Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in Microsoft.Office.Interop.InfoPath.SemiTrust.dll)
Syntax
'Declaration
<GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DataDOMEventObject _
Inherits DataDOMEvent, DocActionEvent, DocReturnEvent, DocEvent
'Usage
Dim instance As DataDOMEventObject
[GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")]
public interface DataDOMEventObject : DataDOMEvent,
DocActionEvent, DocReturnEvent, DocEvent
Hinweise
Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zu dieser COM-Schnittstelle, einschließlich eines Links zu Beschreibungen der Mitglieder, finden Sie unterDataDOMEvent.
Das DataDOMEvent-Objekt stellt mehrere Eigenschaften sowie eine Methode bereit, die in einem Datenüberprüfungsereignis verwendet werden können, um mit den überprüften Daten programmgesteuert zu interagieren und um eine Antwort bereitzustellen, falls die Daten ungültig sind.
Das DataDOMEvent-Objekt wird als Parameter an die Ereignisse OnBeforeChange, OnValidate und OnAfterChange übergeben.
Hinweis
Das OnValidate-Ereignis kann eintreten, ohne dass eine Änderung an dem XML-Dokument erfolgt, das dem Formular zugrunde liegt.
Das DataDOMEvent-Objekt wird verwendet, um Informationen zum geänderten XML-DOM-Knoten (Document Object Model) abzurufen. Es stellt eine Eigenschaft bereit, über die ein Verweis auf das einem Formular zugrunde liegende XML-Dokument abgerufen werden kann. Außerdem stellt das Objekt Eigenschaften zur Behandlung von Änderungen an Daten bereit, einschließlich des Ablehnens der Änderung und des Erstellens einer Fehlermeldung.
Hinweis
Das DataDOMEvent-Objekt wird als Argument an einen der Ereignishandler für Datenüberprüfungen übergeben. Seine Eigenschaften und Methoden sind nur während des Ereignisses verfügbar, an das es übergeben wird.
Beispiele
Im folgenden Beispiel wird die Site-Eigenschaft des DataDOMEvent-Objekts zum Überprüfen des Knotenwertes verwendet. Wenn die Datenüberprüfung einen Fehler erzeugt, wird die ReportError-Methode verwendet, um einen benutzerdefinierten Fehler zu erstellen:
[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
public void field1_OnValidate(DataDOMEvent e)
{
if(e.Site.text != "")
{
int quantity = int.Parse(e.Site.text.ToString());
if(quantity > 50)
{
e.ReportError(e.Site, "Invalid quantity. The total number of each type of block cannot exceed 50.", false, "", 2,"modeless");
}
if(quantity < 0)
{
e.ReportError(e.Site, "Invalid quantity. The total number of each type of block cannot be less than 0.", false,"", 2,"modeless");
}
}
}