DataDOMEventObject - Interface

Un objet d'événement qui est utilisé lors des Microsoft InfoPath é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

'Déclaration
<GuidAttribute("096CD5E5-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface DataDOMEventObject _
    Inherits DataDOMEvent
'Utilisation
Dim instance As DataDOMEventObject
[GuidAttribute("096CD5E5-0786-11D1-95FA-0080C78EE3BB")]
public interface DataDOMEventObject : DataDOMEvent

Remarques

Ce type est le wrapper d’une coclasse requise par le code managé pour l’interopérabilité COM. Utilisez ce type pour accéder aux membres de l’interface COM implémentée par cette coclasse. Pour plus d’informations sur l’interface COM et pour accéder à un lien vers les descriptions de ses membres, voirDataDOMEvent.

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 à l' OnBeforeChange, le OnValidateet les événements OnAfterChange

Notes

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.

Notes

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.

Exemples

Dans l'exemple suivant, l'objet DataDOMEvent est utilisée pour vérifier la valeur du nœud à l'aide de la propriété Site . En cas d'échec de la validation des données, 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

DataDOMEventObject - Membres

Microsoft.Office.Interop.InfoPath - Espace de noms