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

例外処理

コメント

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

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

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

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

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

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

例

次の例では、NotifyHost メソッドによって提供される文字列値を受け取るために、ASPX ページの分離コードに含まれるイベント ハンドラをどのように指定する必要があるかを示しています。この例では、NotifyHost メソッドは "ActionA" を notification パラメータとして提供し、値を受け取ったときにイベント ハンドラが条件付きアクションを実行します。

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 名前空間