DataDOMEventObject-Schnittstelle

Artikel
04/27/2010

Ein Ereignisobjekt, das während eines Datenüberprüfungsereignisses in Microsoft Office InfoPath 2007 verwendet wird.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

<GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(DataDOMEventObjectWrapper))> _
<CLSCompliantAttribute(False)> _
Public Interface DataDOMEventObject
    Inherits DataDOMEvent, DocActionEvent, DocReturnEvent, DocEvent

Dim instance As DataDOMEventObject

[GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")] 
[CoClassAttribute(typeof(DataDOMEventObjectWrapper))] 
[CLSCompliantAttribute(false)] 
public interface DataDOMEventObject : DataDOMEvent, DocActionEvent, DocReturnEvent, 
    DocEvent

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter DataDOMEvent.

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.

Beispiel

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");
   }
}
}

Siehe auch

Referenz

DataDOMEventObject-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über