_XDocumentEventSink2_Event.OnMergeRequest - Événement

Article
05/11/2015

Survient lorsque l’opération de fusion est appelée soit à partir de l’interface utilisateur de Microsoft InfoPath, soit à partir de la ligne de commande via l’option /aggregate.

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 OnMergeRequest As _XDocumentEventSink2_OnMergeRequestEventHandler
'Utilisation
Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnMergeRequestEventHandler

AddHandler instance.OnMergeRequest, handler

event _XDocumentEventSink2_OnMergeRequestEventHandler OnMergeRequest

Remarques

Si la propriété ReturnStatus de l’objet MergeEventObject a la valeur false, InfoPath annule l’opération de fusion. Si une erreur se produit dans le code de l’événement OnMergeRequest, InfoPath l’ignore et s’appuie sur la propriété ReturnStatus. Si la propriété ReturnStatus n’est pas définie de manière explicite, la valeur par défaut false est utilisée.

Pour les formulaires InfoPath stockés dans une bibliothèque de formulaires Windows SharePoint Services, l’événement OnMergeRequest se produit également lors de l’exécution de la méthode MergeDocuments2 du contrôle OpenXMLDocuments. Pour plus d’informations sur le contrôle OpenXMLDocuments, voir le Kit de développement logiciel (SDK) des produits et technologies Microsoft SharePoint 2003, proposé sur le site Web MSDN (Microsoft Developer Network) (https://msdn.microsoft.com/fr-fr/default.aspx).

Notes

Il n’existe aucune interface utilisateur (UI) dans la fenêtre de création de formulaire InfoPath permettant de créer ce gestionnaire d’événements. Pour ajouter ce gestionnaire d’événements au projet, vous devez inclure l’attribut InfoPathEventHandler tel qu’il apparaît dans l’exemple.

Exemples

Dans l’exemple suivant, le gestionnaire d’événements OnMergeRequest effectue une opération de fusion et définit des variables pour indiquer l’état de cette opération :

private bool _merging = false;

[InfoPathEventHandler(EventType=InfoPathEventType.OnMergeRequest)]
public void OnMergeRequest(MergeEvent e)
{ 
 // Set global property to indicate that forms are being merged.
 if (e.Index == 0)
 {
  _merging = true;
 }

 thisXDocument.ImportDOM(e.DOM);
 e.ReturnStatus = true;
  
 if ((e.Index + 1) == e.Count)
 {
  _merging = false;
  thisXDocument.UI.Alert("Your request to merge " + e.Count + " files is now complete.");
 }
}

Voir aussi

Référence

_XDocumentEventSink2_Event interface

_XDocumentEventSink2_Event - Membres

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

Partager via