データソースの構成ウィザード (EntityDataSource コントロール)

2014-10-22

更新 : 2007 年 11 月

ASP.NET フレームワークの EntityDataSource コントロールには、"データソースの構成" という、データソースを初期化するための 2 ページから成るウィザードがあります。ウィザードの 1 ページ目では、WebConfig ファイルから名前付き接続を選択したり、データベースを識別する接続文字列を追加したりできます。ウィザードの 2 ページ目の内容は、ウィザードのオプションまたは独自に作成した別のコマンドテキストの構成に、Select ステートメントが使用されているかどうかによって異なります。

ウィザードページ 1

次の図は、ウィザードの 1 ページ目を表しています。[名前付き接続] ドロップダウンリストでは、プロジェクトの Web.config ファイルにある AdvWksSalesEntities が選択されています。[DefaultContainerName] ドロップダウンリストでも、AdvWksSalesEntities が選択されています。既定では、Entity Data Model (EDM) の実装における接続文字列は、デザインスキーマの EntityContainer によって識別されます。EntityContainer 型の詳細については、「ADO.NET Entity Framework」を参照してください。ウィザードの 1 ページ目は、次のように表示されます。

EntityDataSource 構成ウィザードページ 1

ウィザードの 1 ページ目で初期化される EntityDataSource のプロパティの詳細については、「EntityDataSource コントロールの構成」を参照してください。

ウィザードページ 2

ウィザードの 2 ページ目には、2 とおりのビューがあります。Select プロパティに値が割り当てられたかどうかによって、どちらか一方が表示されます。

単純な Select ウィザードビュー

単純な Select ウィザードビューは、EntityDataSource コントロールの Select プロパティに値が割り当てられていない場合、または Select プロパティに、認識可能なエンティティプロパティがコンマ区切りのリストとして割り当てられている場合に表示されます。値を割り当てる場合は、"item.[Property1], item.[Property2]" という形式を使用します (エスケープの角かっこはあってもなくてかまいません)。DefaultContainerName、EntitySetName、および EntityTypeFilter に対する一連のプロパティはすべて、アプリケーションが使用するデータモデルで有効な値として認識されていることが必要です。

単純な Select ウィザードビューでは、EntitySetName の選択、EntityTypeFilter の入力 (省略可)、およびデータコントロールに表示するプロパティの選択を行うことができます。[EntityTypeFilter] は、継承階層で派生型を使用している場合にのみ必要となります。

[すべて選択 (エンティティ値)] をオンにすると、個々のプロパティを含む結果ではなく、完全なエンティティが返されます。エンティティの値は更新可能です。また、関連するエンティティの主要なプロパティや複合型のメンバを、データバインドコントロールで表示したり変更したりすることもできます。

次の図は、ウィザードの 2 ページ目の単純な Select ビューを示しています。

EntityDataSource 構成ウィザードページ 2A

詳細な Select ウィザードビュー

単純なビューに表示されるオプション以外の値が Select プロパティに設定されていると、次に示す詳細な Select ウィザードビューが表示されます。

EntityDataSource 構成ウィザードページ 2B

[自動挿入を有効にする]、[自動更新を有効にする]、および [自動削除を有効にする] の各チェックボックスは、それぞれ 2 とおりの値を持ちます。単純な Select ウィザードページのプロパティの一覧で [すべて選択] 以外をオンにすると、詳細な Select ウィザードページでこれらのチェックボックスがオフになり、無効になります。詳細な Select ウィザードビューでは、Select テキストボックスに何かを入力するとすぐに、これらのチェックボックスがオフになり、無効になります (図に示したカスタムの select ステートメントを参照)。

メモ :
Entity Framework と同様、Select を使用することによって作成されるのは、データのプロジェクションです。プロジェクションは更新できません。[自動削除を有効にする]、[自動挿入を有効にする]、または [自動更新を有効にする] が有効な場合、Select を設定することはできません。