_XDocument3.NotifyHost(String) メソッド

定義

名前空間:

Microsoft.Office.Interop.InfoPath

アセンブリ:

Microsoft.Office.Interop.InfoPath.dll

ホストしているアプリケーションまたは ASPX ページにカスタム値を提供します。

public:
 void NotifyHost(System::String ^ bstrNotification);

public void NotifyHost (string bstrNotification);

abstract member NotifyHost : string -> unit

Public Sub NotifyHost (bstrNotification As String)

パラメーター

bstrNotification

String

ホストしているアプリケーションまたは ASPX ページのコードによって使用されるカスタム値です。

例

次の例では、NotifyHost メソッドによって提供される文字列値を受け取るために、ASPX ページの分離コードに含まれるイベント ハンドラーをどのように指定する必要があるかを示しています。 この例では、 NotifyHost メソッドがパラメーターとして bstrNotification "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

次の例では、NotifyHost メソッドによって提供される文字列値を受け取るために、ASPX ページの分離コードに含まれるイベント ハンドラーをどのように指定する必要があるかを示しています。 この例では、 NotifyHost メソッドがパラメーターとして bstrNotification "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

注釈

NotifyHost メソッドは、Microsoft SharePoint Server 2010 から実行されている ASPX ページ上の Microsoft.Office.InfoPath.Server.Controls.XmlFormView コントロールで InfoPath フォーム テンプレートがホストされているシナリオで、InfoPath Forms Servicesで使用することを目的としています。 パラメーターに指定する notification 値は、ホスト ASPX ページの分離コードでカスタム アクションを実行するために使用できる文字列です。

ASPX ページで InfoPath フォーム テンプレートをホストする方法については、InfoPath 開発者ポータルの「カスタム Web フォームでの InfoPath フォーム編集環境のホスト」というタイトルの記事を参照してください。

NotifyHost メソッドは、InfoPath アプリケーション自体が別のアプリケーションでコントロールとしてホストされている場合にも使用できますが、そのシナリオでは通常、 プロパティをHost使用して、ホスト アプリケーションのオブジェクト モデルを操作するためのカスタム オブジェクトを取得します。

別のアプリケーションで InfoPath をコントロールとしてホストする方法については、InfoPath 開発者ポータルの「カスタム Web フォームでの InfoPath フォーム編集環境のホスト」というタイトルの記事を参照してください。