_DataDOMEventSink_Event.OnBeforeChange - Événement

  • Article

Se produit une fois que des modifications ont été effectuées dans le document XML sous-jacent d'un formulaire mais avant l'acceptation de ces modifications.

Espace de noms :  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
Event OnBeforeChange As _DataDOMEventSink_OnBeforeChangeEventHandler
'Utilisation
Dim instance As _DataDOMEventSink_Event
Dim handler As _DataDOMEventSink_OnBeforeChangeEventHandler

AddHandler instance.OnBeforeChange, handler

event _DataDOMEventSink_OnBeforeChangeEventHandler OnBeforeChange

Remarques

Ce gestionnaire d'événements permet aux utilisateurs d'annuler une opération DataDOM.

Pendant l'événement OnBeforeChange, le document XML sous-jacent du formulaire est mis en mode lecture seule. Si la propriété ReturnStatus de l'objet DataDOMEventObject est définie sur false, Microsoft InfoPath rejette les modifications apportées et une boîte de message s'affiche. Si une erreur se produit dans le code de l'événement OnBeforeChange, InfoPath rejette les modifications et rétablit l'état précédent des données.

Notes

Il est préférable d'éviter de changer de vue pendant l'événement OnBeforeChange ; les modifications n'ont pas encore été acceptées et le changement de vue risque de provoquer une erreur.

Notes

Dans certains cas, les événements liés aux modifications dans le document XML sous-jacent d'un formulaire peuvent se produire plusieurs fois. Par exemple, lorsque des données existantes sont modifiées, une opération d'insertion et de suppression se produit.

Notes

Si l'événement OnBeforeChange rencontre une erreur de validation, le document ne se charge pas. Vous pouvez utiliser un bloc try/catch dans l'événement OnLoad pour intercepter cette erreur de validation et charger le document malgré tout.

Exemples

Dans l'exemple suivant, le gestionnaire d'événements OnBeforeChange est utilisé pour valider les données d'un champ. Si les données ne sont pas valides, la propriété ReturnStatus de l'objet DataDOMEventObject est utilisée pour rejeter les modifications.

[InfoPathEventHandler(MatchPath="/Customers/Customer/RepVisitDt", EventType=InfoPathEventType.OnBeforeChange)]
public void RepVisitDt_OnBeforeChange(DataDOMEvent e)
{
 IXMLDOMNode phone = thisXDocument.DOM.selectSingleNode    (@"/Customers/CustomerInfo/ContactDates/PhoneContactDt");
 if (phone.text == "")
 {
  e.ReturnMessage = "The Phone Contact Start date must be set prior to the Representative Visit date.";
  e.ReturnStatus = false;
  return;
 }
 // If the data is valid, eventObj.ReturnStatus = true.
 e.ReturnStatus = true;
 return;
}

Voir aussi

Référence

_DataDOMEventSink_Event interface

_DataDOMEventSink_Event - Membres

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms