DataDOMEventObject, interface

Objet d'événement qui est utilisé lors des Microsoft Office InfoPath 2007 événements de validation de données.

Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans microsoft.office.interop.infopath.dll)

Syntaxe

<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

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir DataDOMEvent.

L'objet DataDOMEvent fournit un certain nombre de propriétés et une méthode qui peuvent être utilisées dans un événement de validation de données pour interagir par programmation avec les données en cours de validation et pour fournir une réponse si ces données ne sont pas valides.

L'objet DataDOMEvent est transmis en tant que paramètre aux événements OnBeforeChange, OnValidate et OnAfterChange.

Remarque
L'événement OnValidate peut se produire sans modification dans le document XML sous-jacent du formulaire.

L'objet DataDOMEvent est utilisé pour obtenir des informations sur le nœud DOM XML en cours de modification et fournit également une propriété permettant d'obtenir une référence au document XML sous-jacent d'un formulaire. De plus, il fournit des propriétés permettant de gérer la modification de données, y compris de rejeter la modification et de créer un message d'erreur.

Remarque
L'objet DataDOMEvent est transmis en tant qu'argument à l'un des gestionnaires d'événements de validation de données. Ses propriétés et sa méthode ne sont disponibles que pendant l'événement auquel elles sont transmises.

Exemple

Dans l'exemple suivant, l'objet DataDOMEvent est utilisé pour vérifier la valeur du nœud à l'aide de la propriété Site. Si la validation des données échoue, la méthode ReportError est utilisée pour créer une erreur personnalisée.

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

Voir aussi

Référence

Membres DataDOMEventObject
Microsoft.Office.Interop.InfoPath, espace de noms