FormEvents.Merge 이벤트

사용자 인터페이스에서 양식 병합 명령을 호출하는 경우 또는 /aggregate 명령줄 스위치를 사용하여 InfoPath를 시작하는 경우에 발생합니다.

네임스페이스:  Microsoft.Office.InfoPath
어셈블리:  Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)

구문

‘선언
Public MustOverride Event Merge As MergeEventHandler
‘사용 방법
Dim instance As FormEvents
Dim handler As MergeEventHandler

AddHandler instance.Merge, handler

public abstract event MergeEventHandler Merge

예외

주의

Merge 이벤트는 MergeEventHandler 대리자를 사용하여 바인딩됩니다.

Merge 이벤트는 MergeEventArgs 클래스의 CancelableArgs 속성을 사용하여 취소할 수 있습니다. Cancel 속성을 true로 설정하면 됩니다.

이벤트를 취소하면 InfoPath의 작동 방식은 다음 표에 나와 있는 것처럼 Message 및 MessageDetails 속성을 설정했는지와 어떻게 설정했는지에 따라 달라집니다.

사용자가 예, 모두 예 및 취소 단추를 클릭할 때의 동작은 다음과 같습니다.

MergeEventArgs 개체는 양식의 Merge 이벤트에 대한 이벤트 처리기에 매개 변수로 전달됩니다. MergeEventArgs 개체는 Merge 이벤트가 실행되는 동안 양식의 원본으로 사용하는 XML 문서와 프로그래밍 방식으로 상호 작용하고 병합되는 파일의 개수와 같은 병합 속성을 확인하는 데 사용되는 속성을 제공합니다. MergeEventArgs 개체가 제공하는 속성은 이 이벤트가 실행되는 동안에만 사용할 수 있습니다.

단일 병합 양식 작업 중 병합되는 각 파일에 대해 Merge 이벤트가 한 번 발생하며 해당 이벤트 처리기의 코드가 실행됩니다.

이 형식 또는 멤버는 Microsoft InfoPath Filer에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.

예

다음 예제에서는 Merge 이벤트에 대한 이벤트 처리기가 변수를 설정하여 병합 작업의 상태를 나타내며 XmlForm 클래스의 MergeForm(XPathNavigator) 메서드를 호출하여 병합 작업을 수행하고 병합이 완료되면 메시지를 표시합니다.

private bool _merging = false;
public void FormEvents_Merge(object sender, MergeEventArgs e)
{
   // Set global property to indicate that forms are being merged.
   if (e.Index == 0)
   {
      _merging = true;
   }
   // Merge the current form.
   MergeForm(e.Xml);
   e.CancelableArgs.Cancel = false;

   // Check to see if merging is finished.
   if ((e.Index + 1) == e.Count)
   {
      _merging = false;
      MessageBox.Show("Your request to merge " + e.Count + 
         " files is now complete.");
      // Perform any "after merge" operations here.
   }
}

Private _merging As Boolean = False
Public Sub FormEvents_Merge(ByVal sender As Object, _
   ByVal e As MergeEventArgs)
   ' Set global property to indicate that forms are being merged.
   If (e.Index = 0) Then
      _merging = True
   End If

   ' Merge the current form.
   MergeForm(e.Xml)
   e.CancelableArgs.Cancel = False

   ' Check to see if merging is finished.
   If ((e.Index + 1) = e.Count) Then
      _merging = False
      MessageBox.Show("Your request to merge " + e.Count + 
         " files is now complete.")
      ' Perform any "after merge" operations here.
   End If
End Sub

참고 항목

참조

FormEvents 클래스

FormEvents 멤버

Microsoft.Office.InfoPath 네임스페이스