_XDocumentEventSink2_Event.OnMergeRequest Ereignis

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Tritt auf, wenn der Zusammenführungsvorgang entweder über die Microsoft InfoPath-Benutzeroberfläche oder über die Befehlszeile mithilfe der Option /aggregate aufgerufen wird.

public:
 event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnMergeRequestEventHandler ^ OnMergeRequest;

event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnMergeRequestEventHandler OnMergeRequest;

member this.OnMergeRequest : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnMergeRequestEventHandler

Event OnMergeRequest As _XDocumentEventSink2_OnMergeRequestEventHandler

Ereignistyp

_XDocumentEventSink2_OnMergeRequestEventHandler

Beispiele

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.<span class="label">OnMergeRequest</span>)]
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.");
 }
}

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.<span class="label">OnMergeRequest</span>)]
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.");
 }
}

Hinweise

Wenn die ReturnStatus -Eigenschaft des MergeEventObject Objekts auf false festgelegt ist, bricht InfoPath den Zusammenführungsvorgang ab. Wenn im Code für das OnMergeRequest-Ereignis ein Fehler auftritt, ignoriert InfoPath den Fehler und basiert auf der ReturnStatus-Eigenschaft Wenn die ReturnStatus-Eigenschaft nicht explizit festgelegt ist, 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 Microsoft SharePoint Products and Technologies 2003 Software Development Kit.

Hinweis: Das InfoPath-Formularentwurfsfenster enthält 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.

Gilt für:

Freigeben über