DataDOMEventObject (Interfaz)

Objeto de evento que se utiliza durante los eventos de validación de datos de Microsoft Office InfoPath 2007.

Espacio de nombres: Microsoft.Office.Interop.InfoPath
Ensamblado: Microsoft.Office.Interop.InfoPath (en microsoft.office.interop.infopath.dll)

Sintaxis

<CoClassAttribute(GetType(DataDOMEventObjectClass))> _
<GuidAttribute("096CD5E5-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface DataDOMEventObject
    Inherits DataDOMEvent

Dim instance As DataDOMEventObject

[CoClassAttribute(typeof(DataDOMEventObjectClass))] 
[GuidAttribute("096CD5E5-0786-11D1-95FA-0080C78EE3BB")] 
public interface DataDOMEventObject : DataDOMEvent

Comentarios

Este tipo es un contenedor para una coclase que necesita el código administrado para su interoperabilidad COM. Use este tipo para obtener acceso a los miembros de la interfaz COM implementada por esta coclase. Para obtener información sobre la interfaz COM, así como un vínculo a descripciones de sus miembros, vea DataDOMEvent.

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 eventos OnBeforeChange, OnValidate y OnAfterChange

Nota:
El evento OnValidate puede ocurrir sin que se produzca 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; 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.

Ejemplo

En el ejemplo siguiente, el objeto DataDOMEvent se utiliza para comprobar el valor del nodo mediante la propiedad Site. Si la validación de datos no se realiza con éxito, se utiliza el método ReportError para crear un error personalizado.

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

Vea también

Referencia

DataDOMEventObject (Miembros)
Microsoft.Office.Interop.InfoPath (Espacio de nombres)