方法 : データセットにデータを読み込む
更新 : 2007 年 11 月
「データセットにデータを読み込む」という言い回しは、実際にはデータセットを構成する個々の DataTable オブジェクトにデータを読み込むことを意味します。TableAdapter クエリを実行するか、またはデータ アダプタ (たとえば、SqlDataAdapter) のコマンドを実行して、データ テーブルにデータを読み込みます。
データセットを作成した方法によって、TableAdapter とデータ アダプタのいずれを使用するかが決まります。Visual Studio でデータ ソース構成ウィザードなどのデザイン ツールを使用した場合は、データセットに TableAdapter が含まれています。TableAdapter の詳細については、「TableAdapter の概要」を参照してください。プログラムでデータセットを作成した場合は、通常、データ テーブルにデータを読み込むデータ アダプタを作成する必要があります。詳細については、「データアダプタの概要」を参照してください。
.gif "メモ") メモ : |
|---|
[データ ソース] ウィンドウからフォームに項目をドラッグすると、データ テーブルにデータを読み込むコードが Form_Load イベント ハンドラに自動的に追加されます。コード エディタでフォームを開くと、特定のテーブルにデータを読み込む構文が表示されます。フォームの読み込み時にテーブルにデータを読み込まない場合は、このコードを別のメソッドに移動するか、またはこのコード全体を削除できます。 |
TableAdapter を使用したデータセットへのデータの読み込み
TableAdapter のクエリを呼び出し、データセットのデータ テーブルにデータを読み込むことができます。データを読み込む DataTable を TableAdapter クエリに渡します。クエリがパラメータを使用する場合、パラメータもメソッドに渡します。データセットに複数のテーブルが格納されている場合は、各テーブルに対して個別に TableAdapter を用意し、各テーブルにデータを個別に読み込む必要があります。
| メモ : |
|---|
既定では、TableAdapter クエリを実行するたびに、クエリの結果がテーブルに読み込まれる前にテーブル内のデータが消去されます。TableAdapter の ClearBeforeFill プロパティを false に設定すると、テーブル内の既存のデータを保持したまま結果を追加できます。 |
TableAdapter を使用してデータセットにデータを読み込むには
コード エディタでフォームまたはコンポーネントを開きます。
アプリケーション内で、データ テーブルにデータを読み込む必要のある場所にコードを追加します。クエリでパラメータを使用しない場合は、データを読み込む DataTable を渡します。コードは次のようになります。
Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)this.customersTableAdapter.Fill(this.northwindDataSet.Customers);クエリでパラメータを使用する場合は、データを読み込む DataTable とクエリに必要なパラメータを渡します。クエリの実際のパラメータに応じて異なりますが、コードは次の例のようになります。
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle") CustomersTableAdapter.FillByCityAndState(NorthwindDataSet.Customers, "Seattle", "WA")customersTableAdapter.FillByCity(northwindDataSet.Customers, "Seattle"); customersTableAdapter.FillByCityAndState(northwindDataSet.Customers, "Seattle", "WA");
DataAdapter を使用したデータセットへのデータの読み込み
データ アダプタの Fill メソッドを呼び出すことができます。これにより、アダプタは SelectCommand プロパティで参照されている SQL ステートメントまたはストアド プロシージャを実行し、その結果をデータセットのテーブルに格納します。データセットに複数のテーブルが格納されている場合は、各テーブルに対して個別にデータ アダプタを用意し、各テーブルに個別にデータを読み込む必要があります。
DataAdapter を使用してデータセットにデータを読み込むには
DataAdapter の Fill メソッドを呼び出し、データを読み込む DataSet または DataTable を渡します。たとえば、次のように指定します。
sqlDataAdapter1.Fill(dataset1.Tables("Customers"))sqlDataAdapter1.Fill(dataset1.Tables["Customers"]);通常は、データを読み込む DataTable の名前を指定します。特定のデータ テーブルの代わりに DataSet の名前を渡す場合は、Table1 という名前の DataTable をデータセットに追加し、データベースから結果を読み込みます (これは、データセットの既存の DataTable にデータを読み込む場合と異なります)。詳細については、「DataAdapter からの DataSet の読み込み (ADO.NET)」を参照してください。