TableAdapter クエリの構成ウィザード
更新 : 2007 年 11 月
TableAdapter クエリの構成ウィザードを使用すると、TableAdapter に追加する他のクエリを作成して編集できます。TableAdapter クエリは、TableAdapter に関連付けられたデータ テーブルと同じスキーマに準拠したデータを返す (またはスカラ値を返す)、任意の有効な SQL クエリまたはストアド プロシージャです。ウィザードを完了すると、TableAdapter にメソッドが追加され、このメソッドを呼び出すとクエリが実行されます (たとえば、CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle"))。
ウィザードの実行
クエリをデータセット デザイナにドラッグするか、または既存のクエリを構成します (最初のクエリの下にある任意のクエリ)。
TableAdapter の最初のクエリは TableAdapter のメイン クエリです。メイン クエリを編集すると、TableAdapter 構成ウィザードが開き、TableAdapter のデータ テーブルのスキーマが編集されます。メイン クエリの下にあるすべてのクエリは追加のクエリであり、TableAdapter クエリの構成ウィザードで設定されます。ウィザードを実行する方法の詳細については、「方法 : TableAdapter クエリの構成ウィザードを開始する」を参照してください。
データ接続の選択
接続の一覧から既存の接続を選択するか、[新しい接続] をクリックして [接続の追加] ダイアログ ボックスと [接続の変更] ダイアログ ボックス (一般) を開き、データベースへの接続を作成します。
[接続のプロパティ] ダイアログ ボックスへの入力を完了すると、[接続の詳細情報] 領域に、選択したプロバイダと接続文字列に関する読み取り専用の情報が表示されます。
アプリケーション構成ファイルへの接続文字列の格納
接続文字列をアプリケーション構成ファイルに格納するには、[次の名前で接続を保存する] をオンにします。接続の名前を入力するか、あらかじめ入力されている既定の名前を使用します。
接続文字列をアプリケーション構成ファイルに保存すると、データベース接続の変更時のアプリケーションの保守プロセスが簡単になります。データベース接続に変更が加えられた場合は、アプリケーション構成ファイル内の接続文字列を編集できます。この方法を使うと、ソース コードを編集してアプリケーションを再コンパイルする必要はありません。アプリケーション構成ファイル内の接続文字列を編集する方法については、「方法 : 接続文字列を編集する」を参照してください。
.gif "セキュリティに関するメモ") セキュリティに関するメモ : |
|---|
情報は、アプリケーション構成ファイル内にプレーンテキストとして格納されます。機密情報への未承認アクセスの可能性を減らすために、データを暗号化できます。詳細については、「データの暗号化と復号化」を参照してください。 |
[SQL ステートメントを使用する]
ここでは、[SQL ステートメントを使用する] オプションを選択した場合に、TableAdapter クエリの構成ウィザードを完了する方法について説明します。
[クエリの種類の選択]
ウィザードでは、アプリケーションの要件に応じていくつかの種類のクエリを作成します。データ (データ テーブル) の行を返す SELECT クエリか、またはスカラ値 (Count、Sum などの単一の値) を返す SELECT クエリを選択できます。
[クエリの種類の選択] ページでは、利用可能なクエリの一覧から、作成するクエリの種類を選択します。
.gif "メモ") メモ : |
|---|
INSERT、UPDATE、または DELETE の各ステートメントを作成しても、TableAdapter の Update メソッドを呼び出すときに使用する TableAdapter のコマンドは置き換えられません。たとえば、クエリの種類として UPDATE を選択すると、このウィザードの後半で指定する名前の新しいクエリが作成されます。TableAdapter のこの名前のメソッドを呼び出すことにより、このクエリを実行します。TableAdapter の Update メソッドを呼び出すと、元の TableAdapter を構成したときに作成したステートメントが実行されます。 |
[SQL <クエリの種類> ステートメントの指定]
[SQL <クエリの種類> ステートメントの指定] ページでは、クエリを呼び出したときに実行される SQL ステートメントを入力します。
| ヒント : |
|---|
このウィザードを使用すると、SQL クエリを作成するためのビジュアル ツールであるクエリ ビルダにアクセスできます。クエリ ビルダを開くには、[クエリ ビルダ] をクリックします。クエリ ビルダの使い方の詳細については、「クエリおよびビュー デザイナ ツール」を参照するか、このダイアログ ボックスで F1 キーを押してください。 |
[生成するメソッドの選択]
このページには、このウィザードでクエリに作成するメソッドを選択するために、次のオプションが用意されています。
[DataTable にデータを格納する]
データ テーブルにデータを読み込むメソッドを作成します。このメソッドを呼び出すときにデータ テーブルの名前をパラメータとして渡し、返されたデータをデータ テーブルに読み込みます。[メソッド名] ボックスの既定の名前を変更することもできます。わかりやすい名前を付けると、コードでこのクエリを使用するときに役立ちます。
[DataTable を返す]
データが読み込まれたデータ テーブルを返すメソッドを作成します。アプリケーションによっては、既存のデータ テーブルにデータを読み込む方法に比べ、データが読み込まれたデータ テーブルを返す方法がより適している場合があります。[メソッド名] ボックスの既定の名前を変更することもできます。
[関数名の選択]
関数の名前を入力します。TableAdapter クエリを作成すると、ここで指定した名前のメソッドが TableAdapter に追加されます。 クエリを実行するには、このメソッドを呼び出します。わかりやすい名前を付けると、コードでこのクエリを使用するときに役立ちます。
| メモ : |
|---|
新しいストアド プロシージャを作成する場合は、2 つの名前の指定を求められます。最初の名前は、データベースに作成するストアド プロシージャの名前です。2 番目の名前は、このストアド プロシージャを実行するときに呼び出す TableAdapter のメソッドの名前です。 |
[新しいストアド プロシージャの作成]
ここでは、[新しいストアド プロシージャの作成] オプションを選択する場合に、TableAdapter クエリの構成ウィザードを完了する方法について説明します。
[ストアド プロシージャの生成] ページで、ストアド プロシージャを呼び出すときに実行する SQL ステートメントを入力します。
メモ :このウィザードを使用すると、SQL クエリを作成するためのビジュアル ツールであるクエリ ビルダにアクセスできます。クエリ ビルダを開くには、[クエリ ビルダ] をクリックします。クエリ ビルダの使い方の詳細については、「クエリおよびビュー デザイナ ツール」を参照するか、このダイアログ ボックスで F1 キーを押してください。
[ストアド プロシージャの作成] ページで、次の操作を行います。
新しいストアド プロシージャの名前を入力します。
基になるデータベースにストアド プロシージャを作成するかどうかを選択します。
メモ :データベースにストアド プロシージャを作成できるかどうかは、そのデータベースのセキュリティ設定に応じて決まります。
[ウィザードの結果] ページに、TableAdapter クエリの作成結果が表示されます。ウィザードで問題が発生すると、このページにエラー情報が表示されます。
[既存のストアド プロシージャを使用]
ここでは、[既存のストアド プロシージャを使用] オプションを選択する場合に、TableAdapter クエリの構成ウィザードを完了する方法について説明します。
このウィザードの [既存のストアド プロシージャの選択] ページで、ドロップダウン リストから既存のストアド プロシージャを選択します。
選択したストアド プロシージャの [パラメータ] と [結果] が、参照用として表示されます。
[次へ] をクリックします。
[ストアド プロシージャが返すデータの型の選択]
選択したストアド プロシージャによって返されるデータ型に応じて、ウィザードで作成される TableAdapter メソッドが決まります。
このクエリで返すデータ型を選択します。
[テーブル データ] を選択すると、前述の [生成するメソッドの選択] ページが開きます。このページでは、作成するメソッドの種類、メソッド名、およびページング サポートを指定できます。
[単一値] を選択すると、単一の値を返す型指定されたメソッドが作成されます。このオプションを選択すると、前述の [関数名の選択] ページが開きます。
[値なし] を選択すると、ストアド プロシージャを実行してもデータが返されない、型指定されたメソッドが作成されます。このオプションを選択すると、前述の [関数名の選択] ページが開きます。
[ウィザードの結果]
[ウィザードの結果] ページに、TableAdapter クエリの作成結果が表示されます。ウィザードで問題が発生した場合は、このページに詳細が表示されます。