_XDocumentEventSink2_Event.OnMergeRequest-Ereignis

Artikel
04/27/2010

Tritt ein, wenn der Zusammenführungsvorgang entweder von der Benutzeroberfläche von Microsoft Office InfoPath 2007 oder der Befehlszeile mithilfe der /aggregate-Option aufgerufen wird.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

Event OnMergeRequest As _XDocumentEventSink2_OnMergeRequestEventHandler

Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnMergeRequestEventHandler

AddHandler instance.OnMergeRequest, handler

event _XDocumentEventSink2_OnMergeRequestEventHandler OnMergeRequest

Hinweise

Wenn die ReturnStatus-Eigenschaft des MergeEventObject-Objekts auf false festgelegt wird, wird der Zusammenführungsvorgang von InfoPath abgebrochen. Tritt ein Fehler im Code für das OnMergeRequest-Ereignis auf, wird der Fehler von InfoPath ignoriert und die ReturnStatus-Eigenschaft verwendet. Wurde die ReturnStatus-Eigenschaft nicht explizit festgelegt, wird der Standardwert false verwendet.

Bei InfoPath-Formularen in einer Windows SharePoint Services-Formularbibliothek tritt das OnMergeRequest-Ereignis auch bei der Ausführung der MergeDocuments2-Methode des OpenXMLDocuments-Steuerelements ein. Weitere Informationen zum OpenXMLDocuments-Steuerelement finden Sie im SharePoint Products and Technologies 2003 Software Development Kit (https://msdn.microsoft.com/library/default.asp?url=/library/en-us/spptsdk/html/SPSDKWelcome.asp), das auf der Microsoft SharePoint Produkte und -Technologien-Website (https://msdn.microsoft.com/sharepoint) zur Verfügung steht.

Hinweis:
Im InfoPath-Formularentwurfsfenster gibt es keine Benutzeroberfläche zum Erstellen dieses Ereignishandlers. Um diesen Ereignishandler dem Projekt hinzuzufügen, fügen Sie, wie im Beispiel gezeigt, das InfoPathEventHandler-Attribut hinzu.

Beispiel

Im folgenden Beispiel führt der OnMergeRequest-Ereignishandler einen Zusammenführungsvorgang aus und legt Variablen so fest, dass der Status des Zusammenführungsvorgangs angezeigt wird:

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.");
 }
}

Siehe auch

Referenz

_XDocumentEventSink2_Event-Schnittstelle
_XDocumentEventSink2_Event-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über