SubmitToHostConnection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ホスト環境にデータを送信する接続を表します。
public ref class SubmitToHostConnection abstract : Microsoft::Office::InfoPath::DataConnection
public abstract class SubmitToHostConnection : Microsoft.Office.InfoPath.DataConnection
type SubmitToHostConnection = class
inherit DataConnection
Public MustInherit Class SubmitToHostConnection
Inherits DataConnection
- 継承
例
次の例では、フォームが送信される前にフォーム テンプレートのビジネス ロジックでカスタム操作を実行するコードを記述するパターンを示しています。
public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
// Get the data connection defined in the form template from the
// DataConnections collection and cast to the SubmitToHostConnection
// type.
SubmitToHostConnection submitConnection =
(SubmitToHostConnection)(DataConnections["MyHostConnection"]);
// Write code here to do custom actions that are not
// supported by rules or other declarative settings.
// Execute the submit operation against the connection.
submitConnection.Execute();
}
Public Sub FormEvents_Submit(ByVal sender As Object, _
ByVal e As SubmitEventArg)
' Get the data connection defined in the form template from the
' DataConnections collection and cast to the SubmitToHostConnection
' type.
Dim submitConnection As SubmitToHostConnection = _
DirectCast(DataConnections("MyHostConnection"), _
SubmitToHostConnection)
' Write code here to do custom actions that are not
' supported by rules or other declarative settings.
' Execute the submit operation against the connection.
submitConnection.Execute()
End Sub
注釈
この種類の接続は、InfoPath フォーム編集環境をコントロールとしてホストするアプリケーションによって開かれたフォーム テンプレートで使用します。 ホスト アプリケーションのコードでフォームを送信するためのイベントを処理するメソッドを作成する方法など、コントロールとしての InfoPath のホストの詳細については、「カスタム Windows フォーム アプリケーションでの InfoPath フォーム編集環境のホスト」というタイトルの記事を参照してください。
フォーム テンプレート内のビジネス ロジックから参照できるホスト環境にデータを送信するデータ接続を作成するには、リボンの [データ] タブの [データ接続] コマンドを使用します。 イベントが発生したときに Submit 実行されるイベント ハンドラーを作成する方法については、「方法: イベント ハンドラーを追加する」を参照してください。
コンストラクター
SubmitToHostConnection() |
ホスト環境にデータを送信する接続を表します。 |
プロパティ
Name |
データ接続の名前を取得します。 (継承元 DataConnection) |
メソッド
Execute() |
どの ConnectionTypeConnection クラスから呼び出されたかに応じて、送信されるデータ、クエリ パラメーター、または取得するデータに対して宣言的に定義された値を使用して、データ接続で送信操作またはクエリ操作を実行します。 (継承元 DataConnection) |