次の方法で共有


SubmitToHostConnection クラス

定義

ホスト環境にデータを送信する接続を表します。

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
継承
SubmitToHostConnection

次の例では、フォームが送信される前にフォーム テンプレートのビジネス ロジックでカスタム操作を実行するコードを記述するパターンを示しています。

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)

適用対象