_XDocumentEventSink2_Event.OnMergeRequest, événement

Article
04/27/2010

Survient lorsque l'opération de fusion est appelée soit à partir de l'interface utilisateur de Microsoft Office InfoPath 2007, 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

Event OnMergeRequest As _XDocumentEventSink2_OnMergeRequestEventHandler

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, consultez le kit de développement logiciel des produits et technologies SharePoint 2003 (https://msdn.microsoft.com/library/default.asp?url=/library/en-us/spptsdk/html/SPSDKWelcome.asp) (site en anglais), disponible sur le site Web des produits et technologies Microsoft SharePoint (https://msdn.microsoft.com/sharepoint).

Remarque
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.

Exemple

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
Membres _XDocumentEventSink2_Event
Microsoft.Office.Interop.InfoPath.SemiTrust, espace de noms

Partager via