方法 : 行を返す SQL ステートメントを作成および実行する

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

行を返す SQL ステートメントを実行するには、SQL ステートメントを実行するように構成した TableAdapter クエリを実行します (たとえば、CustomersTableAdapter.Fill(CustomersDataTable))。

アプリケーションで TableAdapter を使用していない場合は、コマンドオブジェクトの ExecuteReader メソッドを呼び出し、そのメソッドの CommandType プロパティを Text に設定します ("コマンドオブジェクト" は、アプリケーションで使用している .NET Framework データプロバイダに固有のコマンドを表します。たとえば、アプリケーションで .NET Framework SQL Server 用データプロバイダを使用している場合、コマンドオブジェクトは SqlCommand です)。

次の例では、TableAdapter またはコマンドオブジェクトのいずれかを使用してデータベースから行を返す SQL ステートメントを実行する方法を示します。TableAdapter やコマンドを使用してクエリを実行する方法の詳細については、「データセットへの読み込みとデータのクエリの概要」を参照してください。

TableAdapter を使用して行を返す SQL ステートメントの実行

この例では TableAdapter クエリの構成ウィザードを使用して TableAdapter クエリを作成する方法を示した後、TableAdapter のインスタンスを宣言してクエリを実行する方法について説明します。

メモ :
使用している設定またはエディションによっては、表示されるダイアログボックスやメニューコマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

使用している設定またはエディションによっては、表示されるダイアログボックスやメニューコマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

TableAdapter を使用して行を返す SQL ステートメントを作成するには

データセットデザイナでデータセットを開きます。詳細については、「方法 : データセットデザイナでデータセットを開く」を参照してください。
TableAdapter がない場合は、TableAdapter を作成します。TableAdapter の作成方法の詳細については、「方法 : TableAdapter を作成する」を参照してください。
SQL ステートメントを使用して行を返すクエリが TableAdapter に既にある場合は、これ以降の手順をスキップし、「TableAdapter のインスタンスを宣言してクエリを実行するには」に進んでください。このクエリがない場合は、手順 4 から継続し、行を返す新しいクエリを作成します。
目的の TableAdapter を右クリックし、ショートカットメニューを使用してクエリを追加します。

TableAdapter クエリの構成ウィザードが開きます。
[SQL ステートメントを使用する] を既定値のまま残し、[次へ] をクリックします。
[複数行を返す SELECT] を既定値のまま残し、[次へ] をクリックします。
SQL ステートメントを入力するか、またはクエリビルダを使用してステートメントを作成し、[次へ] をクリックします。
クエリの名前を入力します。
ウィザードが完了し、TableAdapter にクエリが追加されます。
プロジェクトをビルドします。

TableAdapter のインスタンスを宣言してクエリを実行するには

実行するクエリが含まれた TableAdapter のインスタンスを宣言します。

デザイン時のツールを使ってインスタンスを作成するには、目的の TableAdapter をツールボックスからドラッグします (プロジェクトに含まれるコンポーネントが、プロジェクト名を見出しとしてツールボックスに表示されます)。ツールボックスに TableAdapter が表示されない場合は、プロジェクトのビルドが必要になる場合があります。

または

コードでインスタンスを作成するには、次のコードを DataSet の名前と TableAdapter の名前に置き換えます。

Dim tableAdapter As New DataSetTableAdapters.TableAdapter

メモ :
TableAdapter は、実際には関連するデータセットクラスの中に存在しません。各データセットは、対応する TableAdapter のコレクションを独自の名前空間内に保有しています。たとえば、SalesDataSet という名前のデータセットがある場合、その TableAdapter が格納された SalesDataSetTableAdapters 名前空間が存在します。

TableAdapter は、実際には関連するデータセットクラスの中に存在しません。各データセットは、対応する TableAdapter のコレクションを独自の名前空間内に保有しています。たとえば、SalesDataSet という名前のデータセットがある場合、その TableAdapter が格納された SalesDataSetTableAdapters 名前空間が存在します。

コード内の他のメソッドを呼び出すのと同じようにクエリを呼び出します。このクエリは、TableAdapter のメソッドです。次のコードを TableAdapter とクエリの名前に置き換えます。クエリに必要なすべてのパラメータも渡す必要があります。クエリにパラメータが必要かどうか不明な場合、または必要なパラメータが不明な場合は、IntelliSense でクエリに必要なシグネチャを確認します。クエリでパラメータを使用するかどうかに応じて、コードは次のようになります。

TableAdapter.Query()

TableAdapter.Query(Parameters)

TableAdapter.Query(DataTable, Parameters)

TableAdapter のインスタンスを宣言してクエリを実行する完全なコードは、次のようになります。

Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()
tableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

tableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");

コマンドオブジェクトを使用して行を返す SQL ステートメントの実行

次の例では、コマンドを作成し、行を返す SQL ステートメントを実行する方法を示します。コマンドにパラメータ値を設定および取得する方法については、「方法 : コマンドオブジェクトのパラメータを設定および取得する」を参照してください。

この例では SqlCommand オブジェクトを使用します。次の要素が必要です。

System、System.Data、System.Data.SqlClient、および System.Xml の各名前空間への参照。
sqlConnection1 という名前のデータ接続。
sqlConnection1 の接続先となるデータソースの Customers という名前のテーブル(これがない場合は、データソース用の有効な SQL ステートメントが必要です)。

コマンドオブジェクトを使用して行を返す SQL ステートメントをプログラムで実行するには

コードを実行するメソッドに次のコードを追加します。このコマンド (たとえば、ExecuteReader) の ExecuteReader メソッドを呼び出すと行が返されます。データは、SqlDataReader に返されます。SqlDataReader 内のデータにアクセスする方法の詳細については、「DataReader によるデータの取得 (ADO.NET)」を参照してください。

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim reader As SqlDataReader

cmd.CommandText = "SELECT * FROM Customers"
cmd.CommandType = CommandType.Text
cmd.Connection = sqlConnection1

sqlConnection1.Open()

reader = cmd.ExecuteReader()
' Data is accessible through the DataReader object here.

sqlConnection1.Close()

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
SqlDataReader reader;

cmd.CommandText = "SELECT * FROM Customers";
cmd.CommandType = CommandType.Text;
cmd.Connection = sqlConnection1;

sqlConnection1.Open();

reader = cmd.ExecuteReader();
// Data is accessible through the DataReader object here.

sqlConnection1.Close();