チュートリアル : データセットへのデータの読み込み

[アーティクル]
09/12/2015

このチュートリアルでは、1 つのデータテーブルを含むデータセットを作成し、Northwind サンプルデータベースの Customers テーブルからデータを読み込みます。データセットには、TableAdapter の Fill メソッドを呼び出してデータを読み込みます。

このチュートリアルでは、次の作業を行う方法について説明します。

新しい Windows アプリケーションを作成します。
データソース構成ウィザードを使用して、データセットを作成して構成します。
[データソース] ウィンドウからフォームにドラッグして、データバインド DataGridView を作成します。

必須コンポーネント

このチュートリアルを完了するための要件は次のとおりです。

Northwind サンプルデータベースにアクセスします。詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

Windows アプリケーションの作成

最初に Windows アプリケーションを作成します。

新しい Windows プロジェクトを作成するには

Visual Studio の [ファイル] メニューの [新しいプロジェクト] をクリックします。
プロジェクトに DatasetWalkthrough という名前を付けます。
[Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「.NET Framework を使用したクライアントアプリケーションの開発」を参照してください。

DatasetWalkthrough プロジェクトが作成され、ソリューションエクスプローラーに追加されます。

NorthwindDataSet の作成

この手順では、データソース構成ウィザードを使用して、Northwind サンプルデータベースの Customers テーブルに基づいてデータセットを作成します。接続を作成するには、Northwind サンプルデータベースへのアクセス権を持っている必要があります。 Northwind サンプルデータベースのセットアップの詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

データセットを作成するには

[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウで、[新しいデータソースの追加] をクリックしてデータソース構成ウィザードを起動します。
[データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。
[データ接続の選択] ページで、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストに表示されている場合は選択します。
  
  または
- [新しい接続] を選択して [接続の追加] または [接続の変更] ダイアログボックスを表示します。
データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。
[データベースオブジェクトの選択] ページの [テーブル] ノードを展開します。
Customers テーブルを選択し、[完了] をクリックします。

プロジェクトに NorthwindDataSet が追加され、[データソース] ウィンドウに Customers テーブルが表示されます。

フォームへのコントロールの追加

[データソース] ウィンドウから Windows アプリケーションのフォームに項目をドラッグして、データバインドコントロールを作成します。

Customers テーブルにバインドする DataGridView を作成するには

[データソース] ウィンドウから Form1 にメインの [Customers] ノードをドラッグします。

レコード間をナビゲートするための DataGridView コントロールとツールストリップ (BindingNavigator) がフォームに表示されます。 NorthwindDataSet、CustomersTableAdapter、BindingSource、および BindingNavigator がコンポーネントトレイに表示されます。

データセットにデータを読み込む、生成されたコードの確認

データソースウィンドウからフォームに項目をドラッグすると、データセットにデータを読み込む正しいコードが Form1_Load イベントハンドラーに自動的に追加されます。

データセットにデータを読み込むには

ソリューションエクスプローラーで Form1を選択し、[コードの表示] をクリックします。

Form1_Load イベントハンドラーを確認します。 TableAdapter の Fill メソッドによって、データセットにデータが読み込まれます。

Private Sub Form1_Load() Handles MyBase.Load

    'TODO: This line of code loads data into the 'NorthwindDataSet1.Customers' table.
    'You can move, or remove it, as needed.

    Me.CustomersTableAdapter1.Fill(Me.NorthwindDataSet1.Customers)
End Sub

private void Form1_Load(object sender, EventArgs e)
{
    // TODO: This line of code loads data into the 'northwindDataSet1.Customers' table.
    // You can move, or remove it, as needed.

    this.customersTableAdapter1.Fill(this.northwindDataSet1.Customers);
}

データセットを読み込む必要があるアプリケーションの他の部分にこのコードをコピーすることもできます。

アプリケーションの実行

アプリケーションを実行するには

F5 キーを押してアプリケーションを実行します。
データセットにデータが読み込まれ、DataGridView に表示されます。

次の手順

アプリケーションの要件に応じて、データバインドフォームの作成後に、追加の操作を実行できます。このチュートリアルで行うことができる拡張には次のものがあります。

フォームに検索機能を追加します。詳細については、「方法: パラメータークエリを Windows フォームアプリケーションに追加する」を参照してください。
データベースに更新を送信する機能を追加します。詳細については、「チュートリアル : データベースへのデータの保存 (単一テーブル)」を参照してください。
[データソース] ウィンドウの [ウィザードで DataSet を構成] をクリックして、Orders テーブルをデータセットに追加します。 [Orders] ノード (Customers テーブルの [Fax] 列の下にある) をフォームにドラッグして、関連するデータを表示するコントロールを追加します。詳細については、「方法: 関連するデータを Windows フォームアプリケーションに表示する」を参照してください。