次の方法で共有


TableAdapter クエリの構成ウィザード

 

TableAdapter クエリの構成ウィザードでは、TableAdapter に追加できるクエリを作成して編集できます。 TableAdapter クエリは、TableAdapter に関連付けられたデータ テーブルと同じスキーマに準拠したデータを返す (またはスカラー値を返す)、任意の有効な SQL クエリまたはストアド プロシージャです。 ウィザードを完了すると、TableAdapter にメソッドが追加され、このメソッドを呼び出すとクエリが実行されます (たとえば、CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle"))。

ウィザードの実行

クエリをデータセット デザイナーにドラッグするか、または既存のクエリを構成します (最初のクエリの下にある任意のクエリ)。

TableAdapter の最初のクエリは TableAdapter のメイン クエリです。 メイン クエリを編集すると、TableAdapter 構成ウィザードが開き、TableAdapter のデータ テーブルのスキーマが編集されます。 メイン クエリの下にあるすべてのクエリは追加のクエリであり、TableAdapter クエリの構成ウィザードで設定されます。 ウィザードを実行する方法の詳細については、「方法 : TableAdapter クエリの構成ウィザードを開始する」を参照してください。

データ接続の選択

接続の一覧から既存の接続を選択するか、[新しい接続] をクリックして、データベースへの接続を作成します。

[接続のプロパティ] ダイアログ ボックスへの入力を完了すると、[接続の詳細情報] 領域に、選択したプロバイダーと接続文字列に関する読み取り専用の情報が表示されます。

アプリケーション構成ファイルへの接続文字列の格納

接続文字列をアプリケーション構成ファイルに格納するには、[次の名前で接続を保存する] をオンにします。 接続の名前を入力するか、あらかじめ入力されている既定の名前を使用します。

接続文字列をアプリケーション構成ファイルに保存すると、データベース接続の変更時のアプリケーションの保守プロセスが簡単になります。 データベース接続に変更が加えられた場合は、アプリケーション構成ファイル内の接続文字列を編集できます。 この方法を使うと、ソース コードを編集してアプリケーションを再コンパイルする必要はありません。 アプリケーション構成ファイル内の接続文字列を編集する方法については、「方法: 接続文字列を保存および編集する」を参照してください。

重要

情報は、アプリケーション構成ファイル内にプレーンテキストとして格納されます。 機密情報への未承認アクセスの可能性を減らすために、データを暗号化できます。 詳細については、「Encrypting and Decrypting Data」を参照してください。

[SQL ステートメントを使用する]

ここでは、[SQL ステートメントを使用する] オプションを選択した場合に、TableAdapter クエリの構成ウィザードを完了する方法について説明します。

[クエリの種類の選択]

ウィザードでは、アプリケーションの要件に応じていくつかの種類のクエリを作成します。 データ (データ テーブル) の行を返す SELECT クエリか、またはスカラー値 (CountSum などの単一の値) を返す SELECT クエリを選択できます。

[クエリの種類の選択] ページでは、利用可能なクエリの一覧から、作成するクエリの種類を選択します。

注意

INSERT、UPDATE、または DELETE の各ステートメントを作成しても、TableAdapter の Update メソッドを呼び出すときに使用する TableAdapter のコマンドは置き換えられません。 たとえば、クエリの種類として UPDATE を選択すると、このウィザードの後半で指定する名前の新しいクエリが作成されます。 TableAdapter のこの名前のメソッドを呼び出すことにより、このクエリを実行します。 TableAdapter の Update メソッドを呼び出すと、元の TableAdapter を構成したときに作成したステートメントが実行されます。

[SQL <クエリの種類> ステートメントの指定]

[SQL <クエリの種類> ステートメントの指定] ページでは、クエリを呼び出したときに実行される SQL ステートメントを入力します。

ヒント

このウィザードを使用すると、SQL クエリを作成するためのビジュアル ツールであるクエリ ビルダーにアクセスできます。 クエリ ビルダーを開くには、[クエリ ビルダー] をクリックします。

[生成するメソッドの選択]

このページには、このウィザードでクエリに作成するメソッドを選択するために、次のオプションが用意されています。

[DataTable にデータを格納する]
データ テーブルにデータを読み込むメソッドを作成します。 このメソッドを呼び出すときにデータ テーブルの名前をパラメーターとして渡し、返されたデータをデータ テーブルに読み込みます。

[メソッド名] ボックスの既定の名前を変更することもできます。 わかりやすい名前を付けると、コードでこのクエリを使用するときに役立ちます。

[DataTable を返す]
データが読み込まれたデータ テーブルを返すメソッドを作成します。 アプリケーションによっては、既存のデータ テーブルにデータを読み込む方法に比べ、データが読み込まれたデータ テーブルを返す方法がより適している場合があります。

[メソッド名] ボックスの既定の名前を変更することもできます。

[関数名の選択]

関数の名前を入力します。 TableAdapter クエリを作成すると、ここで指定した名前のメソッドが TableAdapter に追加されます。 クエリを実行するには、このメソッドを呼び出します。 わかりやすい名前を付けると、コードでこのクエリを使用するときに役立ちます。

注意

新しいストアド プロシージャを作成する場合は、2 つの名前の指定を求められます。 最初の名前は、データベースに作成するストアド プロシージャの名前です。2 番目の名前は、このストアド プロシージャを実行するときに呼び出す TableAdapter のメソッドの名前です。

[新しいストアド プロシージャの作成]

ここでは、[新しいストアド プロシージャの作成] オプションを選択する場合に、TableAdapter クエリの構成ウィザードを完了する方法について説明します。

  1. [ストアド プロシージャの生成] ページで、ストアド プロシージャを呼び出すときに実行する SQL ステートメントを入力します。

    注意

    このウィザードを使用すると、SQL クエリを作成するためのビジュアル ツールであるクエリ ビルダーにアクセスできます。 クエリ ビルダーを開くには、[クエリ ビルダー] をクリックします。

  2. [ストアド プロシージャの作成] ページで、次の操作を行います。

    1. 新しいストアド プロシージャの名前を入力します。

    2. 基になるデータベースにストアド プロシージャを作成するかどうかを指定します。

      注意

      データベースにストアド プロシージャを作成できるかどうかは、そのデータベースのセキュリティ設定に応じて決まります。

    [ウィザードの結果] ページに、TableAdapter クエリの作成結果が表示されます。 ウィザードで問題が発生すると、このページにエラー情報が表示されます。

[既存のストアド プロシージャを使用]

ここでは、[既存のストアド プロシージャを使用] オプションを選択する場合に、TableAdapter クエリの構成ウィザードを完了する方法について説明します。

  1. このウィザードの [既存のストアド プロシージャの選択] ページで、ドロップダウン リストから既存のストアド プロシージャを選択します。

    選択したストアド プロシージャの [パラメーター][結果] が、参照用として表示されます。

  2. [次へ] をクリックします。

[ストアド プロシージャが返すデータの型の選択]

選択したストアド プロシージャによって返されるデータ型に応じて、ウィザードで作成される TableAdapter メソッドが決まります。

このクエリで返すデータ型を選択します。

  • [テーブル データ] を選択すると、前述の [生成するメソッドの選択] ページが開きます。このページでは、作成するメソッドの種類、メソッド名、およびページング サポートを指定できます。

  • [単一値] を選択すると、単一の値を返す型指定されたメソッドが作成されます。 このオプションを選択すると、前述の [関数名の選択] ページが開きます。

  • [値なし] を選択すると、ストアド プロシージャを実行してもデータが返されない、型指定されたメソッドが作成されます。 このオプションを選択すると、前述の [関数名の選択] ページが開きます。

[ウィザードの結果]

[ウィザードの結果] ページに、TableAdapter クエリの作成結果が表示されます。 ウィザードで問題が発生した場合は、このページに詳細が表示されます。

参照

TableAdapter の概要
方法 : TableAdapter クエリを編集する
データに関するチュートリアル
Visual Studio でのデータへの Windows フォーム コントロールのバインド
Visual Studio のデータ アプリケーションの概要
Visual Studio でのデータへの接続
アプリケーションでデータを受け取る準備
アプリケーションへのデータのフェッチ
Visual Studio でのデータへのコントロールのバインド
アプリケーションでのデータ編集
データの検証
データの保存