データセットへのデータの読み込み

[アーティクル]
02/21/2013

Transact-SQL クエリの実行とデータセットの読み込みに使用する標準の Visual Studio 機構は、TableAdapter です。

TableAdapter またはコマンドオブジェクト (SqlCommand など) を使用すると、データソースに対して SQL ステートメントまたはストアドプロシージャを実行できます。Visual Studio のデザインツールを使用して作成したデータセットにデータを読み込むには、TableAdapter を使用します。プログラムで作成したデータセットにデータを読み込むには、データアダプターを使用します。アプリケーションでデータセットを使用しない場合は、コマンドオブジェクトを使用して、データベースに対して SQL ステートメントまたはストアドプロシージャを直接実行します。

次のトピックでは、Visual Studio でデータセットにデータを読み込む方法について詳細に説明します。

トピック	Description
方法 : データセットにデータを読み込む	TableAdapter および DataAdapter を使用して、データセットにデータを読み込む方法を説明します。
方法 : 行を返す SQL ステートメントを作成および実行する	TableAdapter のクエリおよび Command オブジェクトを使用して行を返す SQL ステートメントを作成および実行する方法を説明します。
方法 : 単一の値を返す SQL ステートメントを作成および実行する	TableAdapter のクエリおよび Command オブジェクトを使用して単一の値を返す SQL ステートメントを作成および実行する方法を説明します。
方法 : 値を返さない SQL ステートメントを作成および実行する	TableAdapter のクエリおよび Command オブジェクトを使用して値を返さない SQL ステートメントを作成および実行する方法を示します。
方法 : 行を返すストアドプロシージャを実行する	TableAdapter のクエリおよび Command オブジェクトを使用して行を返すストアドプロシージャを実行する方法を説明します。
方法 : 単一の値を返すストアドプロシージャを実行する	TableAdapter のクエリおよび Command オブジェクトを使用して単一の値を返すストアドプロシージャを実行する方法を説明します。
方法 : 値を返さないストアドプロシージャを実行する	TableAdapter のクエリおよび Command オブジェクトを使用して値を返さないストアドプロシージャを実行する方法を説明します。
方法 : コマンドオブジェクトのパラメーターを設定および取得する	クエリおよびストアドプロシージャのパラメーターに値を割り当て、実行されたコマンドから返されたパラメーターの値を読み込む方法を説明します。
チュートリアル : データセットへのデータの読み込み	データセットを作成し、そこにデータベースのデータを読み込む方法を説明します。
チュートリアル : データセットへの XML データの読み込み	XML データをデータセットに読み込んで、DataGridView コントロール内にそのデータセットを表示する Windows アプリケーションの作成方法について説明します。

データセットへのデータの読み込み

Visual Studio デザイン時ツール (データセットデザイナーやデータソース構成ウィザードなど) を使ってデータセットを作成した場合、TableAdapter を使ってデータセットにデータを読み込みます。TableAdapter は、SQL ステートメントまたはストアドプロシージャを実行します。

デザイン時ツールを使わずにデータセットを作成した場合は、データの読み込みや更新にデータアダプターを使用する必要があります。TableAdapter は、.NET Framework 4.5 の実際のクラスではないため、デザイン時ツールを使わずに作成したデータセットを操作する手段としては不適切です。TableAdapter またはデータアダプターを使用したデータセットへのデータの読み込みの詳細については、「方法 : データセットにデータを読み込む」を参照してください。

TableAdapter クエリ

TableAdapter クエリを実行してデータセットにデータを読み込むことができます (より具体的には、データセットを構成する DataTable にデータを読み込みます)。TableAdapter クエリを作成するには、データセットデザイナーの TableAdapter クエリの構成ウィザードを使用します。TableAdapter クエリは指定されたメソッドとして TableAdapter に表示され、TableAdapter のメソッドを呼び出して実行します。TableAdapter クエリの作成と実行の詳細については、次のトピックを参照してください。

コマンドオブジェクト

コマンドオブジェクトを使用すると、DataSet、TableAdapter、または DataAdapter を使用しなくても、データベースに対して SQL ステートメントとストアドプロシージャを直接実行できます(コマンドオブジェクトという用語は、アプリケーションで使用している .NET Framework データプロバイダーに固有のコマンドを表します。たとえば、アプリケーションで .NET Framework SQL Server 用データプロバイダーを使用している場合、コマンドオブジェクトは SqlCommand です)。

データコマンドの CommandType プロパティを CommandType 列挙体のいずれかの値に設定することにより、SQL ステートメントまたはストアドプロシージャを使用してデータへのクエリを実行するコマンドを構成します。SQL ステートメントを実行するには CommandType を Text に設定し、ストアドプロシージャを実行する場合は StoredProcedure に設定します。次に、CommandText プロパティに SQL ステートメントを設定するか、またはストアドプロシージャの名前を設定します。続いて、実行メソッド (ExecuteReader、ExecuteScalar、ExecuteNonQuery) の 1 つを呼び出してデータコマンドを実行できます。

それぞれの .NET Framework Data Providers に、特定のデータベース用に最適化されたコマンドオブジェクトが用意されています。

データコマンドを使用することにより、アプリケーションで次の操作ができます。

結果をデータセットに読み込まずに、結果を直接読み込むことのできる選択コマンドを実行できます。結果を読み込むには、データリーダー (OleDbDataReader、SqlDataReader、OdbcDataReader、または OracleDataReader の各オブジェクト) を使用します。このリーダーは、コントロールをバインドできる読み取り専用の前方向カーソルのように機能します。この方法を使用すると、メモリの使用量を軽減し、読み取り専用データを迅速に読み込むことができます。
データ定義言語 (DDL: Database Definition Language) コマンドを実行して、テーブルやストアドプロシージャなどのデータベースストラクチャを作成、編集、および削除できます。これらの操作を行うには、適切なアクセス許可が必要です。
データベースカタログ情報を取得するコマンドを実行できます。
データセットテーブルを更新して変更をデータベースにコピーする代わりに、動的な SQL コマンドを実行してレコードを更新、挿入、または削除できます。
集約関数 (SUM、COUNT、AVG など) の結果のようなスカラー値 (つまり、単一の値) を返すコマンドを実行できます。
SQL Server データベース (バージョン 7.0 以降) のデータを XML 形式で返すコマンドを実行できます。一般的な使用法としては、クエリを実行してデータを XML 形式で取得し、XSLT 変換を適用してデータを HTML に変換してから、結果をブラウザーに送信します。

コマンドのプロパティには、データベースに対してコマンドを実行するために必要なすべての情報が含まれています。具体的には、次の情報が含まれています。

**接続 **コマンドは、データベースとやり取りするために使用する接続を参照します。
コマンドの名前またはテキスト コマンドには、SQL ステートメントの実際のテキスト、または実行するストアドプロシージャの名前が含まれています。
**パラメーター **コマンドによっては、パラメーターに値を渡す必要があります (入力パラメーター)。また、コマンドは、戻り値または出力パラメーター値の形で値を返す場合があります。各コマンドにはパラメーターのコレクションがあり、個別に設定して値を渡したり、読み取って値を取得したりできます。詳細については、「方法 : コマンドオブジェクトのパラメーターを設定および取得する」を参照してください。

取得する結果に適したメソッドを使用してコマンドを実行する必要があります。たとえば、行を取得する場合は、コマンドの ExecuteReader メソッドを呼び出して、データリーダーにレコードが返されるようにします。UPDATE、INSERT、または DELETE の各コマンドを実行する場合は、コマンドの ExecuteNonQuery メソッドを呼び出して、対象となった行数を示す値が返るようにします。顧客の注文の件数を返すような集約関数を実行する場合は、ExecuteScalar メソッドを呼び出します。

複数結果セット

通常、コマンドオブジェクトは、データの単一のテーブル (行セット) を返すために使用されます。しかし、コマンドは、複数の結果セットを返すプロシージャも実行できます。これはいくつかの異なる方法で行われます。1 つは、コマンドが、複数の結果セットを返すストアドプロシージャを参照する場合です。または、コマンドが 2 つ以上のステートメントやストアドプロシージャ名を含む場合もあります。その場合は、1 つの呼び出しでステートメントまたはプロシージャが順番に実行され、複数の結果セットが返されます。

コマンドに対して複数のステートメントまたはプロシージャを指定する場合、すべて同じ種類である必要があります。たとえば、連続した SQL ステートメントや連続したストアドプロシージャは実行できますが、ストアドプロシージャ呼び出しと SQL ステートメントを同じコマンドで実行することはできません。詳細については、「Retrieving Data Using a DataReader」を参照してください。

[!メモ]

Oracle の場合、.NET Framework Oracle 用データプロバイダーはバッチにまとめられた SQL ステートメントをサポートしていません。ただし、複数の REF CURSOR 出力パラメーターをそれぞれ別個のデータテーブルで使用してデータセットにデータを格納できます。パラメーターを定義して出力パラメーターとしてマークし、REF CURSOR データ型であることを示す必要があります。OracleDataAdapter オブジェクトのデータが REF CURSOR パラメーターからストアドプロシージャに格納される場合は、Update メソッドを使用できません。これは、SQL ステートメントが実行されるときに、テーブル名と列名を決定するために必要な情報が Oracle から提供されないためです。

セキュリティ

CommandType プロパティを Text に設定したデータコマンドを使用するときは、クライアントから送信された情報をデータベースに渡す前に、その情報を十分にチェックしてください。悪意のあるユーザーが、承認なしでデータベースにアクセスしたり、データベースを破壊したりする目的で、変更した SQL ステートメントや追加の SQL ステートメントの送信 (挿入) を試みる場合があります。ユーザーの入力をデータベースに転送する前に、その情報が有効であることを常に検証する必要があります。できる限り、常にパラメーター化されたクエリまたはストアドプロシージャを使用することをお勧めします。