次の方法で共有


チュートリアル : 複数のクエリによる TableAdapter の作成

更新 : 2007 年 11 月

このチュートリアルでは、データ ソース構成ウィザードを使用してデータセット内に TableAdapter を作成します。また、データセット デザイナ内の TableAdapter クエリの構成ウィザードを使用して、TableAdapter 内に 2 つ目のクエリを作成する手順についても説明します。

このチュートリアルでは、以下のタスクを行います。

  • 新しい Windows アプリケーション プロジェクトを作成します。

  • データ ソース構成ウィザードを使用してデータセットを作成することにより、アプリケーションにデータ ソースを作成して設定します。

  • データセット デザイナで新しいデータセットを開きます。

  • TableAdapter クエリの構成ウィザードを使用して TableAdapter にクエリを追加します。

前提条件

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

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

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

新しい Windows アプリケーション プロジェクトを作成するには

  1. Visual Studio で、[ファイル] メニューから新しいプロジェクトを作成します。

  2. [プロジェクトの種類] ペインでプログラミング言語を選択します。

  3. [テンプレート] ペインの [Windows アプリケーション] をクリックします。

  4. プロジェクトに「TableAdapterQueriesWalkthrough」という名前を付け、[OK] をクリックします。

    Visual Studio によってソリューション エクスプローラにプロジェクトが追加され、デザイナに新しいフォームが表示されます。

TableAdapter によるデータベース データ ソースと の作成

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

データ ソースを作成するには

  1. [データ] メニューの [データ ソースの表示] をクリックします。

  2. [データ ソース] ウィンドウで、[新しいデータ ソースの追加] をクリックしてデータ ソース構成ウィザードを起動します。

  3. [データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。

  4. [データ接続の選択] ページで、次のいずれかの操作を行います。

  5. データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。

  6. [アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。

  7. [データベース オブジェクトの選択] ページの [テーブル] ノードを展開します。

  8. Customers テーブルを選択し、[完了] をクリックします。

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

データセット デザイナでデータセットを開く

データセット デザイナでデータセットを開くには

  1. [データ ソース] ウィンドウの [NorthwindDataSet] を右クリックします。

  2. ショートカット メニューの [デザイナで DataSet を編集] をクリックします。

    データセット デザイナで NorthwindDataset が開きます。

CustomersTableAdapter への 2 つ目のクエリの追加

このウィザードでは、Customers データ テーブルと CustomersTableAdapter を含むデータセットが作成されています。ここでは、CustomersTableAdapter に 2 つ目のクエリを追加します。

CustomersTableAdapter にクエリを追加するには

  1. ツールボックスの [DataSet] タブから Customers テーブルに [Query] をドラッグします。

    TableAdapter クエリの構成ウィザードが開きます。

  2. [SQL ステートメントを使用する] を選択し、[次へ] をクリックします。

  3. [複数行を返す SELECT] をクリックし、[次へ] をクリックします。

  4. クエリに次のように WHERE 句を追加します。

    SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
    FROM Customers 
    WHERE City = @City
    
    ms171907.alert_note(ja-jp,VS.90).gifメモ :

    Access バージョンの Northwind を使用している場合は、@City パラメータを疑問符 (?) に置換してください。 (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)

  5. [生成するメソッドの選択] ページで [DataTable にデータを格納する] メソッドに「FillByCity」という名前を付けます。

    ms171907.alert_note(ja-jp,VS.90).gifメモ :

    このチュートリアルでは、[DataTable を返す] メソッドを使用しないので、このチェック ボックスをオフにするか、既定の名前のままにします。

  6. [次へ] をクリックし、ウィザードを終了します。

    FillByCity クエリが CustomersTableAdapter に追加されます。

追加のクエリを実行するコードのフォームへの追加

クエリを実行するには

  1. ソリューション エクスプローラで Form1 を選択し、[デザイナの表示] をクリックします。

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

  3. [表示] メニューの [コード] をクリックしてコード ビューに変更します。

  4. Form1_Load イベント ハンドラ内のコードを、FillByCity クエリを実行する以下のコードに置き換えます。

    Dim cityValue As String = "Seattle"
    CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
    
    string cityValue = "Seattle";
    customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
    

アプリケーションの実行

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

  • F5 キーを押します。

  • グリッドに、City 値が Seattle の顧客が読み込まれます。

次の手順

アプリケーションに機能を追加するには

  • TextBox コントロールおよび Button コントロールを追加し、テキスト ボックスの値をクエリに渡します。 (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).

  • データセット内のデータ テーブルの ColumnChanging イベントまたは RowChanging イベントに検証ロジックを追加します。詳細については、「データの妥当性検査の概要」を参照してください。

参照

処理手順

方法 : TableAdapter を作成する

方法 : TableAdapter クエリを作成する

概念

TableAdapter の概要

データの新機能

その他の技術情報

データに関するチュートリアル

Visual Studio でのデータへの接続

アプリケーションでデータを受け取る準備

アプリケーションへのデータのフェッチ

Windows アプリケーションのフォームでのデータの表示

アプリケーションでのデータ編集