Interfaccia DataDOMEventObject

Articolo
04/27/2010

Oggetto evento utilizzato durante gli eventi di convalida dei dati di Microsoft Office InfoPath 2007.

Spazio dei nomi: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Sintassi

<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

Osservazioni

Questo tipo è un wrapper per una coclasse richiesta dal codice gestito per l'interoperabilità COM. Utilizzare questo tipo per accedere ai membri dell'interfaccia COM implementata dalla coclasse. Per informazioni sull'interfaccia COM e un collegamento alle descrizioni dei relativi membri, vedere DataDOMEvent.

L'oggetto DataDOMEvent implementa numerose proprietà e un metodo che possono essere utilizzati in un evento di convalida dei dati per interagire a livello di programmazione con i dati in corso di convalida e fornire una risposta in caso di non validità dei dati.

L'oggetto DataDOMEvent viene passato come parametro agli eventi OnBeforeChange, OnValidate e OnAfterChange.

Nota:
L'evento OnValidate può verificarsi senza che siano state apportate modifiche nel documento XML sottostante del modulo.

L'oggetto DataDOMEvent viene utilizzato per ottenere informazioni sul nodo DOM (Document Object Model) XML in corso di modifica e implementa inoltre una proprietà che consente di ottenere un riferimento al documento XML sottostante di un modulo. Inoltre, rende disponibili proprietà per gestire le modifiche dei dati, ad esempio per rifiutare una modifica o creare un messaggio di errore.

Nota:
L'oggetto DataDOMEvent viene passato come argomento a uno dei gestori eventi di convalida dei dati. Le proprietà e il metodo dell'oggetto sono disponibili solo durante l'evento a cui viene passato l'oggetto.

Esempio

Nell'esempio seguente, l'oggetto DataDOMEvent viene utilizzato per controllare il valore del nodo mediante la proprietà Site. Se la convalida dei dati ha esito negativo, viene utilizzato il metodo ReportError per creare un errore personalizzato.

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

Vedere anche

Riferimenti

Membri DataDOMEventObject
Spazio dei nomi Microsoft.Office.Interop.InfoPath

Condividi tramite