DataDOMEventObject Interface

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Objet d’événement utilisé pendant les événements de validation des données Microsoft InfoPath.

public interface class DataDOMEventObject : Microsoft::Office::Interop::InfoPath::SemiTrust::DataDOMEvent

[System.Runtime.InteropServices.Guid("096cd5e5-0786-11d1-95fa-0080c78ee3bb")]
public interface DataDOMEventObject : Microsoft.Office.Interop.InfoPath.SemiTrust.DataDOMEvent

type DataDOMEventObject = interface
    interface DataDOMEvent
    interface DocActionEvent
    interface DocReturnEvent
    interface DocEvent

Public Interface DataDOMEventObject
Implements DataDOMEvent

Attributs

GuidAttribute

Implémente

DataDOMEvent

Exemples

Dans l’exemple suivant, l’objet DataDOMEvent est utilisé pour case activée la valeur du nœud à l’aide de la Site propriété . Si la validation des données échoue, la ReportError(Object, String, Boolean, String, Int32, String) méthode est utilisée pour créer une erreur personnalisée.

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
public void field1_OnValidate(<span class="label">DataDOMEvent</span> e)
{
if(e.Site.text != "")
{
   int quantity = int.Parse(e.Site.text.ToString());
   if(quantity &gt; 50)
   {
      e.ReportError(e.Site, "Invalid quantity. The total number of each type of block cannot exceed 50.", false, "", 2,"modeless");
  }
   if(quantity &lt; 0)
   {
      e.ReportError(e.Site, "Invalid quantity. The total number of each type of block cannot be less than 0.", false,"", 2,"modeless");
   }
}
}

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, y compris un lien vers les descriptions de ses membres, consultezDataDOMEvent .

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 passé en tant que paramètre aux OnBeforeChangeévénements , OnValidateet 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 passé en tant qu’argument à l’un des gestionnaires d’événements de validation des données. Ses propriétés et sa méthode ne sont disponibles que pendant l'événement auquel elles sont transmises.

Propriétés

IsUndoRedo	Obtient une valeur indiquant si l'événement de validation de données se produit pendant une opération d'annulation ou de rétablissement. (Hérité de DataDOMEvent)
MatchExpression	Obtient l'expression XPath pour le nœud DOM XML pour lequel l'événement est actuellement en cours de traitement. (Hérité de DataDOMEvent)
NewValue	Obtient la valeur d'un nœud DOM XML mis à jour ou inséré lors d'un événement de validation de données. (Hérité de DataDOMEvent)
OldValue	Obtient la valeur d'origine d'un nœud DOM (Document Object Model) XML mis à jour ou supprimé pendant un événement de validation de données. (Hérité de DataDOMEvent)
Operation	Obtient le type d'action appliqué à un nœud DOM (Document Object Model) XML pendant un événement de validation de données. (Hérité de DataDOMEvent)
Parent	Obtient une référence au nœud DOM (Document Object Model) XML du parent du nœud DOM XML en cours de modification pendant un événement de validation de données. (Hérité de DataDOMEvent)
ReturnMessage	Obtient ou définit le message d'erreur renvoyé en cas d'échec de l'événement de validation de données. (Hérité de DataDOMEvent)
ReturnStatus	Obtient ou définit une valeur indiquant l'état renvoyé de l'événement de validation de données. (Hérité de DataDOMEvent)
Site	Obtient une référence au nœud DOM XML dans lequel l'événement de validation de données est actuellement en cours de traitement. (Hérité de DataDOMEvent)
Source	Obtient une référence au modèle DOM XML dans lequel l'événement de validation de données se produit. (Hérité de DataDOMEvent)
XDocument	Obtient une référence à l’objet XDocument associé à l’objet DataDOMEventObject pendant un événement de validation de données. (Hérité de DataDOMEvent)

Méthodes

ReportError(Object, String, Boolean, String, Int32, String)

Crée un ErrorObject objet et l’ajoute à la ErrorsCollection collection. (Hérité de DataDOMEvent)