DataConnection.Execute メソッド

どの ConnectionTypeConnection クラスから呼び出されたかに応じて、送信されるデータ、クエリ パラメータ、または取得するデータに対して宣言的に定義された値を使用して、データ接続で送信操作またはクエリ操作を実行します。

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

構文

'宣言
Public MustOverride Sub Execute
'使用
Dim instance As DataConnection

instance.Execute

public abstract void Execute ()

例外処理

コメント

フォーム テンプレートをデザインするときは、[ツール] メニューの [フォーム送信オプション] コマンドを使用して、送信先、およびフォーム テンプレート ファイルのソリューション定義ファイル (.xsf) に格納される関連設定を定義できます。また、[ツール] メニューの [データ接続] コマンドを使用して、データの送受信に関する設定を定義することもできます。この設定も、ソリューション定義ファイル (.xsf) に格納されます。Execute メソッドを使用し、宣言的に定義されたこれらの設定を使用して、データ接続で送信操作やクエリ操作を実行します。

DataConnection.Execute メソッドは、データ接続を表すすべてのクラスによって継承され、EmailSubmitConnection.Execute() メソッドなどのように、そのクラスの継承されたメソッドとして公開されます。継承しているクラスが表すデータ接続の種類に応じて、Execute メソッドは、その接続に適した宣言されている送信操作またはクエリ操作を実行します。

AdoQueryConnection

クエリ

AdoSubmitConnection

送信

EmailSubmitConnection

送信

FileQueryConnection

クエリ

FileSubmitConnection

送信

SharepointListQueryConnection

クエリ

WebServiceConnection

送信またはクエリ

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

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

例

次の例では、ADOQueryConnection クラスの Command プロパティを使用してデータ接続の SQL コマンド テキストを更新した後、DataConnection クラスの Execute メソッドを使用して、フォームのデータを更新するクエリを実行しています。

public void RefreshData_Clicked(object sender, ClickedEventArgs e)
{
   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   // Get the employee's ID from the EmpID field in 
   // the main data source.
   XPathNavigator myNav = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", 
      NamespaceManager);
   // Assign the value from the field to a variable.
   string employeeID = myNav.InnerXml;

   // Change the SQL command for Employees connection to retrieve 
   // the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

   // Execute the updated command against the data connection to 
   // refresh the data.
   myAdoQueryConnection.Execute();
}

Public Sub RefreshData_Clicked(ByVal sender As Object, ByVal e As ClickedEventArgs)
   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

   ' Get the employee's ID from the EmpID field in 
   ' the main data source.
   Dim myNav As XPathNavigator = _
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", _
      NamespaceManager)
   Dim employeeID As String = myNav.InnerXml

   ' Change the SQL command for Employees connection to retrieve 
   ' the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = _
      "select * from [Employees] where [EmployeeID] = " + employeeID

   ' Execute the updated command against the data connection to 
   ' refresh the data.
    myAdoQueryConnection.Execute()
End Sub

関連項目

参照

DataConnection クラス
DataConnection のメンバ
Microsoft.Office.InfoPath 名前空間