Interfaz DataDOMEventObject

Artículo
05/12/2015

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

Espacio de nombres: Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado: Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
<GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DataDOMEventObject _
    Inherits DataDOMEvent, DocActionEvent, DocReturnEvent, DocEvent
'Uso
Dim instance As DataDOMEventObject

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

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. Encontrará información sobre la interfaz COM, así como vínculos a las descripciones de sus miembros, enDataDOMEvent.

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 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.

Ejemplos

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.

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

Vea también

Referencia

Miembros DataDOMEventObject

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust

Share via