次の方法で共有

_XDocument3.NotifyHost(String) メソッド

  • リファレンス

定義

名前空間:
Microsoft.Office.Interop.InfoPath.SemiTrust
アセンブリ:
Microsoft.Office.Interop.InfoPath.SemiTrust.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 2007 フォーム編集環境のホスト」というタイトルの記事を参照してください。

NotifyHost メソッドは Microsoft InfoPath の新しいメソッドであるため、このメソッドにアクセスするには、型を_XDocument3宣言してキャストする必要があります。 詳細については、「[方法] InfoPath 2003 と互換性のないオブジェクト モデルのメンバーを使用する方法」を参照してください。

重要: このメンバーにアクセスできるのは、現在開いているフォームと同じドメインで実行されているフォーム、またはクロスドメインアクセス許可が付与されているフォームのみです。

適用対象