ダイアログボックス

2011-08-09

アダプターの SelectCommand オブジェクトが呼び出されたときにデータセットにデータがどのように格納されるかを確認できます。このダイアログボックスを使うと、アダプターが適切なデータを返すこと、すべてのテーブルマップが正しく機能すること、およびデータセットへのデータの格納時にエラーが発生しないことをテストできます。また、アダプターに渡すパラメーター値を変更したときの結果をテストすることもできます。

注意

以前のバージョンの Visual Studio では、アプリケーションとデータベースの通信にデータアダプターが使用されていました。データアダプターは現在でも .NET Framework データプロバイダー (ADO.NET) のメインコンポーネントですが、デザイナーによって生成されるコンポーネントである TableAdapter を使うと、アプリケーションとデータベース間でデータを操作するプロセスは簡略化されます。 TableAdapter の操作方法の詳細については、「TableAdapter の概要」を参照してください。

データアダプターのプレビュー機能は、アダプターから直接生成されていないデータセットにデータを格納するのにアダプターを使用する場合に、特に役に立ちます。

次のいずれかのアクションを実行すると、このダイアログボックスが表示されます。

[データ] メニューの [データのプレビュー] をクリックします。このメニューは、フォームまたはコンポーネントにデータアダプターを追加したときにだけ使用できます。
[プロパティ] ウィンドウの下部にある [データのプレビュー] のリンクをクリックします。このリンクは、データアダプターのプロパティを表示していると使用できます。

ユーザーインターフェイス要素一覧

[データアダプター]
作業しているフォームまたはコンポーネントで使用できるデータアダプターの一覧が表示されます。プレビューするアダプターを選択します。すべてのデータアダプターを使用したときの結果を表示するには、[<すべてのデータアダプター>] を選択します。
[データセットの格納]
コマンドを実行し、[結果] ボックスにデータを表示します。

データアダプターがデータセットにデータを格納している間にエラーが発生した場合は、メッセージボックスにエラーが表示されます。発生する可能性のあるエラーは次のとおりです。
- データ型が一致していない。
- 実行している SQL ステートメントまたはストアドプロシージャに構文エラーがある。
- テーブルのマップにエラーがある。たとえば、アダプターの MissingMappingAction プロパティまたは MissingSchemaAction プロパティに Error が設定されていて、データベースとデータセットの列名に不一致がある場合に行う事柄がテーブルのマップで完全に記述されていない場合は、エラーが発生します。
- 接続に問題がある場合。
[パラメーター]
指定したデータアダプターの SelectCommand オブジェクトで参照されている SQL の Select ステートメントまたはストアドプロシージャに必要なパラメーターが表示されます。パラメーターが必要ない場合は、このグリッドは空白になります。

パラメーターごとにグリッドの 1 行が使われ、パラメーター名と格納されるデータの型が表示されます。各パラメーターに対する値は [値] ボックスに入力します。パラメーターで認められている場合は、代わりに、[値] ボックスの一覧の [<DEFAULT>] または [<NULL>] を選択できます。
[ターゲットのデータセット]
プレビューコマンドがデータを格納するデータセットを指定します。プロジェクトで使用できるすべてのデータセットから選択したり、または型指定されていないデータセット (スキーマのないデータセット) への格納を選択したりできます。
[データテーブル]
データセットにあるデータテーブルの一覧が表示されます。データアダプタデータアダプターによって格納されるレコードを表示するには、テーブル名を選択します。普通、各データアダプターはデータセット内の 1 つのテーブルを設定します。複数のテーブルにデータを格納する場合は、この一覧でテーブルを選択し、そのテーブルの結果を見ることができます。
[結果]
データセット内のデータが表示されます。データベースから返されてすべてのテーブルマップが適用された後のデータがどのように見えるかが示されます。グリッド内のデータは読み取り専用です。

結果に複数のテーブルがある場合は、[データテーブル] の一覧でテーブルの名前を選択することにより、特定のテーブルの内容を表示できます。
[結果をクリア]
選択したテーブルのデータをすべてクリアします。すべてのテーブルをクリアするには、[データテーブル] の一覧で 1 つずつ選択し、それぞれについて [結果をクリア] をクリックします。