Entity Framework 4.0 の新機能

[アーティクル]
07/13/2023

このチュートリアルシリーズは、Entity Framework チュートリアルシリーズを使用してはじめにによって作成された Contoso University Web アプリケーションに基づいています。以前のチュートリアルを完了していない場合は、このチュートリアルの開始点として、作成したアプリケーションをダウンロードできます。完全なチュートリアルシリーズによって作成されたアプリケーションをダウンロードすることもできます。チュートリアルについて質問がある場合は、 ASP.NET Entity Framework フォーラムに投稿できます。

前のチュートリアルでは、Entity Framework を使用する Web アプリケーションのパフォーマンスを最大化するためのいくつかの方法について説明しました。このチュートリアルでは、Entity Framework のバージョン 4 で最も重要な新機能をいくつか確認し、すべての新機能のより完全な概要を提供するリソースへのリンクを示します。このチュートリアルで強調表示されている機能は次のとおりです。

外部キーの関連付け。
ユーザー定義 SQL コマンドの実行。
モデルファースト開発。
POCO のサポート。

さらに、このチュートリアルでは、Entity Framework の次のリリースで提供される機能である コードファースト開発について簡単に説明します。

チュートリアルを開始するには、Visual Studio を起動し、前のチュートリアルで使用していた Contoso University Web アプリケーションを開きます。

Foreign-Keyの関連付け

Entity Framework のバージョン 3.5 にはナビゲーションプロパティが含まれていましたが、データモデルに外部キープロパティは含まれていませんでした。たとえば、テーブルの CourseIDStudentGrade 列と StudentID 列はエンティティからStudentGrade省略されます。

このアプローチの理由は、厳密に言えば、外部キーは物理的な実装の詳細であり、概念データモデルに属していないということです。ただし、実際的には、外部キーに直接アクセスできる場合は、コード内のエンティティを操作する方が簡単です。

データモデルの外部キーでコードを簡略化する方法の例については、 DepartmentsAdd.aspx ページをコーディングせずにコーディングする方法を検討してください。エンティティではDepartment、 Administrator プロパティはエンティティ内の Person にPersonID対応する外部キーです。新しい部門とその管理者の間の関連付けを確立するために、データ送信コントロールのイベントハンドラーで ItemInserting プロパティの値Administratorを設定する必要がありました。

protected void DepartmentsDetailsView_ItemInserting(object sender, DetailsViewInsertEventArgs e)
{
    e.Values["Administrator"] = administratorsDropDownList.SelectedValue;
}

データモデルに外部キーがない場合は、エンティティがエンティティセットに追加される前にエンティティ自体への参照をItemInserting取得するために、データバインドコントロールのイベントではなく、データソースコントロールのイベントを処理Insertingします。その参照がある場合は、次の例のようにコードを使用して関連付けを確立します。

departmentEntityToBeInserted.PersonReference.EntityKey = new System.Data.EntityKey("SchoolEntities.Departments", "PersonID", Convert.ToInt32(administratorsDropDownList.SelectedValue));

departmentEntityToBeInserted.Person = context.People.Single(p => p.PersonID == Convert.ToInt32(administratorsDropDownList.SelectedValue));

外部キーの関連付けに関する Entity Framework チームのブログ投稿でわかるように、コードの複雑さの違いがはるかに大きい場合もあります。より単純なコードのために概念データモデルの実装の詳細を使用することを希望するユーザーのニーズを満たすために、Entity Framework では、データモデルに外部キーを含めるオプションが提供されるようになりました。

Entity Framework の用語では、外部キーをデータモデルに含める場合は 外部キーの関連付けを使用し、外部キーを除外する場合は 独立した関連付けを使用します。

User-Defined SQL コマンドの実行

以前のバージョンの Entity Framework では、独自の SQL コマンドをその場で作成して実行する簡単な方法はありませんでした。 Entity Framework で動的に生成された SQL コマンドか、ストアドプロシージャを作成して関数としてインポートする必要がありました。バージョン 4 では、クラスをObjectContext追加ExecuteStoreQueryしExecuteStoreCommand、メソッドを使用して、任意のクエリをデータベースに直接渡すのを容易にします。

Contoso University の管理者が、ストアドプロシージャを作成してデータモデルにインポートするプロセスを実行しなくても、データベースで一括変更を実行できるようにするとします。最初の要求は、データベース内のすべてのコースのクレジット数を変更できるページ用です。 Web ページで、すべての Course 行 Credits の列の値を乗算するために使用する数値を入力できるようにする必要があります。

Site.Master マスター ページを使用する新しいページを作成し、UpdateCredits.aspx という名前を付けます。次に、という名前Content2のコントロールに次のマークアップをContent追加します。

<h2>Update Credits</h2>
    Enter the number to multiply the current number of credits by: 
    <asp:TextBox ID="CreditsMultiplierTextBox" runat="server"></asp:TextBox>
    <br /><br />
    <asp:Button ID="ExecuteButton" runat="server" Text="Execute" OnClick="ExecuteButton_Click" /><br /><br />
    Rows affected:
    <asp:Label ID="RowsAffectedLabel" runat="server" Text="0" ViewStateMode="Disabled"></asp:Label><br /><br />

このマークアップは、 TextBox ユーザーが乗数の値を入力できるコントロール、 Button コマンドを実行するためにクリックするコントロール、影響 Label を受ける行数を示すコントロールを作成します。

UpdateCredits.aspx.cs を開き、次usingのステートメントとボタンのClickイベントのハンドラーを追加します。

using ContosoUniversity.DAL;

protected void ExecuteButton_Click(object sender, EventArgs e)
{
    using (SchoolEntities context = new SchoolEntities())
    {
        RowsAffectedLabel.Text = context.ExecuteStoreCommand("UPDATE Course SET Credits = Credits * {0}", CreditsMultiplierTextBox.Text).ToString();
    }
}

このコードでは、テキストボックスの値を使用して SQL Update コマンドを実行し、ラベルを使用して影響を受ける行数を表示します。ページを実行する前に、 Courses.aspx ページを実行して、一部のデータの "before" 画像を取得します。

UpdateCredits.aspx を実行し、乗数として「10」と入力し、[実行] をクリックします。

Courses.aspx ページをもう一度実行して、変更されたデータを確認します。

(クレジットの数を元の値に戻す場合は、UpdateCredits.aspx.cs でページをにCredits / {0}変更Credits * {0}して再実行し、除数として「10」と入力します)。

コードで定義したクエリの実行の詳細については、「方法: データソースに対してコマンドを直接実行する」を参照してください。

Model-First開発

これらのチュートリアルでは、最初にデータベースを作成し、データベース構造に基づいてデータモデルを生成しました。 Entity Framework 4 では、代わりにデータモデルから開始し、データモデル構造に基づいてデータベースを生成できます。データベースがまだ存在しないアプリケーションを作成する場合、モデル優先のアプローチでは、物理的な実装の詳細を気にすることなく、アプリケーションの概念的に意味のあるエンティティとリレーションシップを作成できます。 (これは、開発の初期段階でのみ当てはまります。最終的にデータベースが作成され、運用データが含まれるようになり、モデルから再作成することは実用的ではなくなります。その時点で、データベース優先のアプローチに戻ります)。

チュートリアルのこのセクションでは、単純なデータモデルを作成し、そこからデータベースを生成します。

ソリューションエクスプローラーで DAL フォルダーを右クリックし、[新しい項目の追加] を選択します。 [ 新しい項目の追加 ] ダイアログボックスの [ インストールされているテンプレート ] で [ データ ] を選択し、 ADO.NET エンティティデータモデル テンプレートを選択します。新しいファイルに AlumniAssociationModel.edmx という名前を 付け、[追加] をクリックします。

これにより、エンティティデータモデルウィザードが起動します。 [ モデルコンテンツの選択] ステップで、[ 空のモデル ] を選択し、[完了] をクリック します。

[Entity Data Model]\(エンティティデータモデル\) Designerが開き、空のデザイン画面が表示されます。 [ツールボックス] から [エンティティ] 項目をデザインサーフェイスにドラッグします。

エンティティ名をから Entity1 に Alumnus変更し、プロパティ名を Id に AlumnusId変更し、という名前 Nameの新しいスカラープロパティを追加します。新しいプロパティを追加するには、列の名前を変更した後に Enter キーを Id 押すか、エンティティを右クリックして [ スカラープロパティの追加] を選択します。新しいプロパティの既定の型はです String。この簡単なデモでは問題ありませんが、もちろん、[ プロパティ ] ウィンドウでデータ型などを変更できます。

同じ方法で別のエンティティを作成し、という名前を付けます Donation。プロパティをにIdDonationId変更し、という名前DateAndAmountのスカラープロパティを追加します。

これら 2 つのエンティティ間に関連付けを追加するには、エンティティを Alumnus 右クリックし、[ 追加] を選択し、[ 関連付け] を選択します。

[ 関連付けの追加 ] ダイアログボックスの既定値は、目的の値 (一対多、ナビゲーションプロパティを含める、外部キーを含める) であるため、[OK] をクリック するだけです。

デザイナーは、関連付け行と外部キープロパティを追加します。

これで、データベースを作成する準備ができました。デザイン画面を右クリックし、[ モデルからデータベースを生成] を選択します。

これにより、データベースの生成ウィザードが起動します。 (エンティティがマップされていないことを示す警告が表示された場合は、当面は無視できます)。

[ データ接続の選択] ステップで 、[ 新しい接続] をクリックします。

[接続のプロパティ] ダイアログボックスで、ローカル SQL Server Express インスタンスを選択し、データベースにという名前を付けますAlumniAssociation。

データベースを作成するかどうかを確認するメッセージが表示されたら、[ はい ] をクリックします。 [ データ接続の選択] ステップが再び表示されたら、[ 次へ] をクリックします。

[ 概要と設定] ステップで 、[ 完了] をクリックします。

データ定義言語 (DDL) コマンドを含む .sql ファイルが作成されますが、コマンドはまだ実行されていません。

SQL Server Management Studio などのツールを使用してスクリプトを実行し、テーブルを作成します。これは、はじめにチュートリアルシリーズの最初のチュートリアルのデータベースを作成Schoolしたときに行った場合と同様です。 (データベースをダウンロードした場合を除く)。

これで、モデルを使用する AlumniAssociation のと同じ方法で、Web ページでデータモデルを School 使用できるようになりました。これを試すには、テーブルにいくつかのデータを追加し、データを表示する Web ページを作成します。

サーバーエクスプローラーを使用して、テーブルと Donation テーブルに次の行をAlumnus追加します。

Site.Master マスター ページを使用する Alumni.aspx という名前の新しい Web ページを作成します。という名前Content2のコントロールに次のマークアップをContent追加します。

<h2>Alumni</h2>
    <asp:EntityDataSource ID="AlumniEntityDataSource" runat="server" 
        ContextTypeName="ContosoUniversity.DAL.AlumniAssociationModelContainer" EnableFlattening="False" 
        EntitySetName="Alumni">
    </asp:EntityDataSource>
    <asp:GridView ID="AlumniGridView" runat="server" 
        DataSourceID="AlumniEntityDataSource" AutoGenerateColumns="False"
        OnRowDataBound="AlumniGridView_RowDataBound"
        DataKeyNames="AlumnusId">
        <Columns>
            <asp:BoundField DataField="Name" HeaderText="Name" SortExpression="Name" />
            <asp:TemplateField HeaderText="Donations">
                <ItemTemplate>
                    <asp:GridView ID="DonationsGridView" runat="server" AutoGenerateColumns="False">
                        <Columns>
                            <asp:BoundField DataField="DateAndAmount" HeaderText="Date and Amount" />
                        </Columns>
                    </asp:GridView>
                </ItemTemplate>
            </asp:TemplateField>
        </Columns>
    </asp:GridView>

このマークアップでは、入れ子になった GridView コントロール、同窓生の名前を表示する外側のコントロール、および寄付の日付と金額を表示する内部コントロールが作成されます。

Alumni.aspx.cs を開きます。 usingデータアクセス層のステートメントと、外部GridViewコントロールRowDataBoundのイベントのハンドラーを追加します。

using ContosoUniversity.DAL; 

// ...

protected void AlumniGridView_RowDataBound(object sender, GridViewRowEventArgs e)
{
    if (e.Row.RowType == DataControlRowType.DataRow)
    {
        var alumnus = e.Row.DataItem as Alumnus;
        var donationsGridView = (GridView)e.Row.FindControl("DonationsGridView");
        donationsGridView.DataSource = alumnus.Donations.ToList();
        donationsGridView.DataBind();
    }
}

このコードは、現在の行AlumnusのエンティティのナビゲーションプロパティをDonations使用して、内部GridViewコントロールをデータバインドします。

ページを実行します。

(注: このページはダウンロード可能なプロジェクトに含まれていますが、機能させるには、ローカル SQL Server Express インスタンスにデータベースを作成する必要があります。データベースは、App_Data フォルダーに .mdf ファイルとして含まれていません)。

Entity Framework のモデル優先機能の使用の詳細については、「Entity Framework 4 の Model-First」を参照してください。

POCO サポート

ドメイン駆動型の設計手法を使用する場合は、ビジネスドメインに関連するデータと動作を表すデータクラスを設計します。これらのクラスは、データの格納 (永続化) に使用される特定のテクノロジとは無関係である必要があります。つまり、永続化は無視する必要があります。永続化を無視すると、単体テストプロジェクトでテストに最も便利な永続化テクノロジを使用できるため、クラスを単体テストしやすくなります。以前のバージョンの Entity Framework では、エンティティクラスがクラスから EntityObject 継承する必要があり、Entity Framework 固有の機能が多く含まれていたため、永続化の無視に対するサポートは限定的でした。

Entity Framework 4 では、クラスから EntityObject 継承されないエンティティクラスを使用する機能が導入されているため、永続化は無視されます。 Entity Framework のコンテキストでは、このようなクラスは通常、 プレーン古い CLR オブジェクト (POCO、または POCO) と呼ばれます。 POCO クラスは手動で記述することも、Entity Framework によって提供されるテキストテンプレート変換ツールキット (T4) テンプレートを使用して、既存のデータモデルに基づいて自動的に生成することもできます。

Entity Framework での POCO の使用の詳細については、次のリソースを参照してください。

POCO エンティティの操作。これは、POCO の概要を示す MSDN ドキュメントであり、より詳細な情報を含む他のドキュメントへのリンクが含まれています。
チュートリアル: Entity Framework 用の POCO テンプレートこれは Entity Framework 開発チームからのブログ投稿で、POCO に関する他のブログ投稿へのリンクがあります。

Code-First開発

Entity Framework 4 での POCO サポートでは、データモデルを作成し、エンティティクラスをデータモデルにリンクする必要があります。 Entity Framework の次のリリースには、 コードファースト開発と呼ばれる機能が含まれます。この機能を使用すると、データモデルデザイナーまたはデータモデル XML ファイルを使用しなくても、独自の POCO クラスで Entity Framework を使用できます。 (したがって、このオプションは コード専用とも呼ばれています。 code-first と code-only はどちらも同じ Entity Framework 機能を参照します)。

開発に対するコード優先アプローチの使用方法の詳細については、次のリソースを参照してください。

Entity Framework 4 を使用したコードファースト開発。これは、コードファースト開発を紹介する Scott Guthrie によるブログ投稿です。
Entity Framework 開発チームブログ - CodeOnly というタグが付いた投稿
Entity Framework 開発チームブログ - タグ付けされたコードを投稿する
MVC ミュージックストアのチュートリアル - パート 4: モデルとデータアクセス
MVC 3 のはじめに - パート 4: Entity Framework Code-First 開発

さらに、Contoso University アプリケーションと同様のアプリケーションを構築する新しい MVC Code-First チュートリアルは、2011 年春に公開される予定です。 https://asp.net/entity-framework/tutorials

詳細情報

これで、Entity Framework の新機能の概要と、Entity Framework チュートリアルシリーズの継続について説明します。ここでは説明していない Entity Framework 4 の新機能の詳細については、次のリソースを参照してください。

ADO.NET の新機能 Entity Framework のバージョン 4 の新機能に関する MSDN トピック。
Entity Framework 4 のリリースの発表バージョン 4 の新機能に関する Entity Framework 開発チームのブログ投稿。

[戻る]

次の方法で共有