_XDocumentEventSink2_Event.OnMergeRequest 事件

定义

命名空间:

Microsoft.Office.Interop.InfoPath.SemiTrust

程序集:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

在从 Microsoft InfoPath 用户界面或使用 /aggregate 选项从命令行调用合并操作时发生。

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 

事件类型

_XDocumentEventSink2_OnMergeRequestEventHandler

示例

在下面的示例中，OnMergeRequest 事件处理程序执行合并操作，并且设置变量以表示合并操作的状态：

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

在下面的示例中，OnMergeRequest 事件处理程序执行合并操作，并且设置变量以表示合并操作的状态：

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

注解

ReturnStatus如果 对象的 属性MergeEventObject设置为 false，InfoPath 将取消合并操作。 如果 OnMergeRequest 事件的代码中发生错误，InfoPath 将忽略该错误，并依赖于 ReturnStatus 属性。如果未显式设置 ReturnStatus 属性，则使用默认值 false 。

对于存储在 Windows SharePoint Services 表单库中的 InfoPath 表单，执行 OpenXMLDocuments 控件的 MergeDocuments2 方法时也会发生 OnMergeRequest 事件。 有关 OpenXMLDocuments 控件的详细信息，请参阅 Microsoft SharePoint 产品和技术 2003 软件开发工具包

注意：InfoPath 表单设计窗口中没有用于创建此事件处理程序的用户界面 (UI) 。 若要将该事件处理程序添加到项目，请包含出现在示例中的 InfoPathEventHandler 属性。