DataDOMEventObject Schnittstelle

Definition

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Ein Ereignisobjekt, das bei Microsoft InfoPath-Datenüberprüfungsereignissen verwendet wird.

public interface class DataDOMEventObject : Microsoft::Office::Interop::InfoPath::DataDOMEvent

[System.Runtime.InteropServices.Guid("096CD5E5-0786-11D1-95FA-0080C78EE3BB")]
public interface DataDOMEventObject : Microsoft.Office.Interop.InfoPath.DataDOMEvent

type DataDOMEventObject = interface
    interface DataDOMEvent

Public Interface DataDOMEventObject
Implements DataDOMEvent

Abgeleitet

Microsoft.Office.Interop.InfoPath.DataDOMEventObjectClass

Attribute

GuidAttribute

Implementiert

DataDOMEvent

Beispiele

Im folgenden Beispiel wird das DataDOMEvent-Objekt verwendet, um den Wert des Knotens mithilfe der Site -Eigenschaft zu überprüfen. Wenn die Datenüberprüfung fehlschlägt, wird die ReportError(Object, String, Boolean, String, Int32, String) -Methode verwendet, um einen benutzerdefinierten Fehler zu erstellen.

public void field1_OnValidate(<span class="label">DataDOMEvent</span> e)
{
 if(e.Site.text != "")
 {
  int quantity = int.Parse(e.Site.text.ToString());
  if(quantity &gt; 50)
  {
   e.ReportError(e.Site, "Invalid quantity. The total number of each type of block cannot exceed 50.", false, "", 2,"modeless");
  }
  if(quantity &lt; 0)
  {
   e.ReportError(e.Site, "Invalid quantity. The total number of each type of block cannot be less than 0.", false,"", 2,"modeless");
  }
 }
}

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 zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, 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 OnBeforeChangeEreignisse , OnValidateund übergeben OnAfterChange .

Hinweis: Das OnValidate-Ereignis kann ohne Änderung des dem Formular zugrunde liegenden XML-Dokuments auftreten.

Das DataDOMEvent-Objekt wird verwendet, um Informationen über den zu ändernden XML-DOM-Knoten (Document Object Model) abzurufen, und es stellt auch eine -Eigenschaft zum Abrufen eines Verweises auf das einem Formular zugrunde liegende XML-Dokument bereit. Darüber hinaus werden Eigenschaften für die Verarbeitung der Datenänderung bereitgestellt, z. B. das Ablehnen der Änderung und das Erstellen einer Fehlermeldung.

Hinweis: Das DataDOMEvent-Objekt wird als Argument an einen der Datenüberprüfungsereignishandler übergeben. Seine Eigenschaften und Methoden sind nur während des Ereignisses verfügbar, an das es übergeben wird.

Eigenschaften

IsUndoRedo	Ruft einen Wert ab, der angibt, ob das Datenüberprüfungsereignis während eines Vorgangs zum Rückgängigmachen oder Wiederholens eintritt. (Geerbt von DataDOMEvent)
MatchExpression	Ruft den XPath-Ausdruck für den XML-DOM-Knoten (Document Object Model) ab, für den das Ereignis zurzeit verarbeitet wird. (Geerbt von DataDOMEvent)
NewValue	Ruft den Wert eines XML-DOM-Knotens (Document Object Model) ab, der während eines Datenüberprüfungsereignisses aktualisiert oder eingefügt wird. (Geerbt von DataDOMEvent)
OldValue	Ruft den ursprünglichen Wert eines XML-DOM-Knotens (Document Object Model) ab, der während eines Datenüberprüfungsereignisses aktualisiert oder gelöscht wird. (Geerbt von DataDOMEvent)
Operation	Ruft den Typ der Aktion ab, die während eines Datenüberprüfungsereignisses auf einen XML-DOM-Knoten (Document Object Model) angewendet wird. (Geerbt von DataDOMEvent)
Parent	Ruft einen Verweis auf den XML-DOM-Knoten (Document Object Model) des übergeordneten Elements des XML-DOM-Knotens ab, der während eines Datenüberprüfungsereignisses geändert wird. (Geerbt von DataDOMEvent)
ReturnMessage	Ruft die Fehlermeldung ab, die bei nicht erfolgreicher Datenüberprüfung zurückgegeben wird, oder legt die Meldung fest. (Geerbt von DataDOMEvent)
ReturnStatus	Ruft einen Wert ab, der den Rückgabestatus des Datenüberprüfungsereignisses angibt, oder legt diesen Wert fest. (Geerbt von DataDOMEvent)
Site	Ruft einen Verweis auf den XML-DOM-Knoten (Document Object Model) ab, auf dem das Datenüberprüfungsereignis zurzeit verarbeitet wird. (Geerbt von DataDOMEvent)
Source	Ruft einen Verweis auf den XML-DOM-Knoten (Document Object Model) ab, auf dem das Datenüberprüfungsereignis zurzeit erfolgt. (Geerbt von DataDOMEvent)
XDocument	Ruft einen Verweis auf das XDocument -Objekt ab, das dem DataDOMEventObject -Objekt während eines Datenüberprüfungsereignisses zugeordnet ist. (Geerbt von DataDOMEvent)

Methoden

ReportError(Object, String, Boolean, String, Int32, String)

Erstellt ein ErrorObject -Objekt und fügt es der ErrorsCollection Auflistung hinzu. (Geerbt von DataDOMEvent)