다음을 통해 공유

XmlForm.NotifyHost 메서드

  • 아티클

호스팅 응용 프로그램 또는 ASPX 페이지에 사용자 지정 값을 제공합니다.

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

구문

‘선언
Public MustOverride Sub NotifyHost ( _
    notification As String _
)
‘사용 방법
Dim instance As XmlForm
Dim notification As String

instance.NotifyHost(notification)

public abstract void NotifyHost(
    string notification
)

매개 변수

  • notification
    형식: System.String
    호스팅 응용 프로그램 또는 ASPX 페이지의 코드에 사용할 사용자 지정 값입니다.

예외

예외 조건
ArgumentNullException

이 메서드에 전달된 매개 변수가 Null 참조(Visual Basic의Nothing )입니다.
ArgumentException

이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다.

주의

NotifyHost 메서드는 InfoPath 양식 서식 파일이 InfoPath Forms Services가 있는 Microsoft SharePoint Server 2010에서 실행되는 ASPX 페이지에 Microsoft.Office.InfoPath.Server.Controls.XmlFormView 컨트롤로 호스팅된 경우에 사용됩니다. notification 매개 변수에 제공하는 값은 호스트 ASPX 페이지의 코드 숨김에서 사용자 지정 작업을 수행하는 데 사용할 수 있는 문자열입니다.

ASPX 페이지에서 InfoPath 양식 서식 파일을 호스팅하는 방법에 대한 자세한 내용은 MSDN의 InfoPath Developer Portal(영문일 수 있음)에서 "사용자 지정 웹 양식에서 InfoPath 양식 편집 환경 호스팅" 문서를 참조하십시오.

또한 NotifyHost 메서드는 InfoPath 응용 프로그램 자체가 다른 응용 프로그램에서 컨트롤로 호스팅된 경우에도 사용할 수 있습니다. 단, 이 경우에는 일반적으로 Host 속성을 사용하여 호스트 응용 프로그램의 개체 모델에서 사용할 사용자 지정 개체를 검색합니다.

다른 응용 프로그램에서 InfoPath를 호스팅하는 방법에 대한 자세한 내용은 MSDN의 InfoPath Developer Portal(영문일 수 있음)에서 "사용자 지정 Windows Form 응용 프로그램에서 InfoPath 편집 환경 호스팅" 문서를 참조하십시오.

이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.

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

예

다음 코드 예제에서는 NotifyHost 메서드에서 제공하는 문자열 값을 받기 위해 ASPX 페이지의 코드 숨김에서 이벤트 처리기를 작성하는 방법을 보여 줍니다. 이 예제에서 NotifyHost 메서드는 notification 매개 변수로 "ActionA"를 제공하고 이벤트 처리기는 값이 검색된 경우 조건부 작업을 수행합니다.

private void XmlFormView1_NotifyHost(Object sender, 
   NotifyHostEventArgs e)
{
   if (e.Notification == "ActionA")
   {
      // Code to perform if 'ActionA' is received.
   }

   else 
   {
      // Code to perform an alternative action.
   }
}

Private Sub XmlFormView1_NotifyHost(sender As Object, _
   e As NotifyHostEventArgs)
   If (e.Notification = "ActionA") Then
      ' Code to perform if 'ActionA' is received.
   Else 
      ' Code to perform an alternative action.
   End If
End Sub

참고 항목

참조

XmlForm 클래스

XmlForm 멤버

Microsoft.Office.InfoPath 네임스페이스