_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 プロパティが MergeEventObjectfalse に設定されている場合、InfoPath はマージ操作を取り消します。 OnMergeRequest イベントのコードでエラーが発生した場合、InfoPath はエラーを無視し、ReturnStatus プロパティに依存します。ReturnStatus プロパティが明示的に設定されていない場合、既定値は false が使用されます。

Windows SharePoint Services フォーム ライブラリに格納されている InfoPath フォームの場合は、OpenXMLDocuments コントロールの MergeDocuments2 メソッドが実行されたときにも OnMergeRequest イベントが発生します。 OpenXMLDocuments コントロールの詳細については、「Microsoft SharePoint Products and Technologies 2003 Software Development Kit」を参照してください。

注: このイベント ハンドラーを作成するための InfoPath フォーム デザイン ウィンドウには、ユーザー インターフェイス (UI) はありません。 プロジェクトにこのイベント ハンドラーを追加するには、以下の例に示すように、InfoPathEventHandler 属性を含めてください。