DataDOMEventObject Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Objeto de evento que se usa durante los eventos de validación de datos de Microsoft InfoPath.

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

[System.Runtime.InteropServices.Guid("096cd5e5-0786-11d1-95fa-0080c78ee3bb")]
public interface DataDOMEventObject : Microsoft.Office.Interop.InfoPath.SemiTrust.DataDOMEvent

type DataDOMEventObject = interface
    interface DataDOMEvent
    interface DocActionEvent
    interface DocReturnEvent
    interface DocEvent

Public Interface DataDOMEventObject
Implements DataDOMEvent

Atributos

GuidAttribute

Implementaciones

DataDOMEvent

Ejemplos

En el ejemplo siguiente, el objeto DataDOMEvent se usa para comprobar el valor del nodo mediante la Site propiedad . Si se produce un error en la validación de datos, el ReportError(Object, String, Boolean, String, Int32, String) método se usa para crear un error personalizado.

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
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");
   }
}
}

Comentarios

Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Para obtener información sobre la interfaz COM, incluido un vínculo a las descripciones de sus miembros, consulteDataDOMEvent .

El objeto DataDOMEvent proporciona varias propiedades y un método que se pueden utilizar en un evento de validación de datos para interactuar mediante programación con los datos validados, así como para proporcionar una respuesta en caso de que los datos no sean válidos.

El objeto DataDOMEvent se pasa como parámetro a los OnBeforeChangeeventos , OnValidatey .OnAfterChange

Nota: El evento OnValidate puede producirse sin ningún cambio en el documento XML subyacente del formulario.

El objeto DataDOMEvent se utiliza para obtener información sobre el nodo Modelo de objetos de documento (DOM) XML modificado y también proporciona una propiedad para obtener una referencia al documento XML subyacente del formulario. Además, proporciona propiedades para controlar los cambios de datos, lo que incluye el rechazo de cambios y la creación de un mensaje de error.

Nota: El objeto DataDOMEvent se pasa como argumento a uno de los controladores de eventos de validación de datos. Sus propiedades y su método únicamente están disponibles durante el evento al que se pasa.

Propiedades

IsUndoRedo	Obtiene un valor que indica si el evento de validación de datos ocurre durante una operación de deshacer o de repetir. (Heredado de DataDOMEvent)
MatchExpression	Obtiene la expresión XPath del nodo del modelo de objetos de documento (DOM) XML para el que se está procesando el evento. (Heredado de DataDOMEvent)
NewValue	Obtiene el valor del nodo de un modelo de objetos de documento (DOM) XML que se está actualizando o que se inserta durante un evento de validación. (Heredado de DataDOMEvent)
OldValue	Obtiene el valor original del nodo de un modelo de objetos de documento (DOM) XML que se está actualizando o se elimina durante un evento de validación. (Heredado de DataDOMEvent)
Operation	Obtiene el tipo de acción que se aplica a un nodo de modelo de objetos de documento (DOM) XML durante un evento de validación de datos. (Heredado de DataDOMEvent)
Parent	Obtiene una referencia al nodo del modelo de objetos de documento (DOM) XML del principal del nodo XML DOM modificado durante un evento de validación de datos. (Heredado de DataDOMEvent)
ReturnMessage	Obtiene o establece el mensaje de error que se devolverá si se produce un error en el evento de validación de datos. (Heredado de DataDOMEvent)
ReturnStatus	Obtiene o establece un valor que indica el estado de retorno del evento de validación de datos. (Heredado de DataDOMEvent)
Site	Obtiene una referencia al nodo del modelo de objetos de documento (DOM) XML en el que se está procesando actualmente el evento de validación de datos. (Heredado de DataDOMEvent)
Source	Obtiene una referencia al nodo del modelo de objetos de documento (DOM) XML en el que se está produciendo el evento de validación de datos. (Heredado de DataDOMEvent)
XDocument	Obtiene una referencia al XDocument objeto asociado al DataDOMEventObject objeto durante un evento de validación de datos. (Heredado de DataDOMEvent)

Métodos

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

Crea un ErrorObject objeto y lo agrega a la ErrorsCollection colección. (Heredado de DataDOMEvent)