_XDocument3.NotifyHost メソッド

2010-04-27

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

このメソッドは、CLS に準拠していません。

名前空間: Microsoft.Office.Interop.InfoPath.SemiTrust
アセンブリ: Microsoft.Office.Interop.InfoPath.SemiTrust (microsoft.office.interop.infopath.semitrust.dll 内)

構文

'宣言
<DispIdAttribute(58)> _
Sub NotifyHost ( _
    bstrNotification As String _
)
'使用
Dim instance As _XDocument3
Dim bstrNotification As String

instance.NotifyHost(bstrNotification)

[DispIdAttribute(58)] 
void NotifyHost (
    string bstrNotification
)

パラメータ

bstrNotification
ホストしているアプリケーションまたは 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 開発者ポータル」にある「カスタム Web フォームで InfoPath 2007 フォーム編集環境をホストする」という記事を参照してください。

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

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

NotifyHost メソッドは、Microsoft Office InfoPath 2007 の新しい機能なので、このメソッドにアクセスするには、宣言して _XDocument3 型にキャストする必要があります。詳細については、「[方法] InfoPath 2003 と互換性のない Microsoft.Office.Interop.InfoPath.SemiTrust のメンバを使用する方法」を参照してください。

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

例

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

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

次の方法で共有

_XDocument3.NotifyHost メソッド

構文

パラメータ

コメント

例

関連項目

参照

その他のリソース