Language

XmlForm.NotifyHost(String) メソッド

定義

名前空間:
Microsoft.Office.InfoPath
アセンブリ:
Microsoft.Office.InfoPath.dll

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

public:
 abstract void NotifyHost(System::String ^ notification);
public abstract void NotifyHost(string notification);
abstract member NotifyHost : string -> unit
Public MustOverride Sub NotifyHost (notification As String)

パラメーター

notification
String

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

例外

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

ArgumentException

このメソッドに渡されるパラメーターは無効です。 たとえば、型または形式が正しくありません。

例

次のコードの例では、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

注釈

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 開発者ポータルの「カスタム Windows フォーム アプリケーションでの InfoPath 編集環境のホスト」というタイトルの記事を参照してください。

このメンバは、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームだけがアクセスできます。

この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開いたフォームで実行されるコードからアクセスできます。

適用対象