次の方法で共有

移行に関する注意事項 (Entity Framework)

  • [アーティクル]

ADO.NET Entity Framework には、既存のアプリケーションにとっていくつかの利点があります。 特に重要な利点の 1 つが、概念モデルを使用して、アプリケーションで使用するデータ構造をデータ ソースのスキーマから分離できることです。 これにより、ストレージ モデルやデータ ソース自体の将来の変更が容易になり、その変更を補うための変更をアプリケーションに加える必要がなくなります。 Entity Framework を使用する利点の詳細については、「エンティティ フレームワークの概要」および「Entity Data Model」を参照してください。

Entity Framework の利点を活用するために既存のアプリケーションを Entity Framework に移行することができます。 移行作業の一部はすべてのアプリケーションに共通です。 こうした共通の作業には、.NET Framework Version 3.5 Service Pack 1 (SP1) 以降を使用するようにアプリケーションをアップグレードする作業のほか、モデルおよびマッピングの定義や Entity Framework の構成などが含まれます。 そのほか、アプリケーションを Entity Framework に移行する際には、 移行するアプリケーションの種類やアプリケーションの特定の機能に依存する注意点もあります。 このトピックでは、既存のアプリケーションをアップグレードする際に最適な方法を選択するために役立つ情報を紹介します。

全般的な移行の注意点

アプリケーションを Entity Framework に移行する際には次の点に注意してください。

  • .NET Framework Version 3.5 SP1 以降を使用しているアプリケーションはどれでも Entity Framework に移行できますが、アプリケーションが使用するデータ ソースのデータ プロバイダーで Entity Framework がサポートされている必要があります。

  • データ ソース プロバイダーが Entity Framework をサポートしていても、そのプロバイダーのすべての機能が Entity Framework でサポートされるとは限りません。

  • 大規模なアプリケーションや複雑なアプリケーションの場合、アプリケーション全体を一度に Entity Framework に移行する必要はありません。 ただし、Entity Framework を使用しない部分がアプリケーションにある場合、それらの部分については、データ ソースが変更された場合に変更が必要になります。

  • Entity Framework は ADO.NET データ プロバイダーを使用してデータ ソースにアクセスするため、Entity Framework が使用するデータ プロバイダー接続をアプリケーションの他の部分と共有できます (たとえば、Entity Framework は SqlClient プロバイダーを使用して SQL Server データベースにアクセスします)。 詳細については、「Entity Framework 用の EntityClient プロバイダー」を参照してください。

共通の移行作業

既存アプリケーションの Entity Framework への移行パスは、アプリケーションの種類と既存のデータ アクセス計画の両方に依存します。 ただし、以下の作業は、既存のアプリケーションを Entity Framework に移行する際に常に実行する必要があります。

Cc716791.note(ja-jp,VS.100).gif注 :
以降で Entity Data Model ツールを使用すると、これらの作業はすべて自動的に実行されます。詳細については、「Entity Data Model ウィザードを使用する方法 (Entity Framework)」を参照してください。

  1. アプリケーションをアップグレードします。

    以前のバージョンの Visual Studio と .NET Framework を使用して作成したプロジェクトは、 SP1 と .NET Framework Version 3.5 SP1 以降を使用するようにアップグレードする必要があります。

  2. モデルおよびマッピングを定義します。

    モデル ファイルとマッピング ファイルでは、概念モデルのエンティティ、データ ソースの構造 (テーブル、ストアド プロシージャ、ビューなど)、およびエンティティとデータ ソース構造との間のマッピングを定義します。 詳細については、「方法: モデル ファイルとマッピング ファイルを手動で定義する (Entity Framework)」を参照してください。

    ストレージ モデルに定義されている型は、データ ソースのオブジェクトと名前が一致している必要があります。 また、既存のアプリケーションでデータがオブジェクトとして公開されている場合は、概念モデルに定義するエンティティおよびプロパティの名前を既存のデータ クラスおよびプロパティの名前に一致させる必要があります。 詳細については、「カスタム オブジェクトを操作できるようにモデリング ファイルとマッピング ファイルをカスタマイズする方法 (Entity Framework)」を参照してください。

    Cc716791.note(ja-jp,VS.100).gif注 :
    Entity Data Model デザイナーを使用すると、概念モデルのエンティティの名前を既存のオブジェクトに合わせて変更できます。詳細については、「ADO.NET Entity Data Model Designer」を参照してください。

  3. 接続文字列を定義します。

    Entity Framework で概念モデルに対してクエリを実行する際には特殊な形式の接続文字列を使用します。 この接続文字列は、モデル ファイルとマッピング ファイルに関する情報とデータ ソースへの接続に関する情報をカプセル化したものです。 詳細については、「接続文字列を定義する方法 (Entity Framework)」を参照してください。

  4. Visual Studio プロジェクトを構成します。

    Entity Framework アセンブリへの参照とモデル ファイルおよびマッピング ファイルを Visual Studio プロジェクトに追加する必要があります。 これらのマッピング ファイルをプロジェクトに追加することで、接続文字列で指定された場所にアプリケーションと共に配置されるようにすることができます。 詳細については、「Entity Framework プロジェクトを手動で構成する方法」を参照してください。

既存のオブジェクトを含むアプリケーションの注意点

.NET Framework 4 以降では、Entity Framework は POCO ("plain old" CLR object、永続化非依存オブジェクトとも呼ばれます) をサポートしています。 ほとんどの場合、既存のオブジェクトを少し変更すれば Entity Framework で使用できます。 詳細については、「POCO エンティティの使用 (Entity Framework)」を参照してください。 アプリケーションを Entity Framework に移行し、Entity Framework ツールによって生成されたデータ クラスを使用することもできます。 詳細については、「Entity Data Model ウィザードを使用する方法 (Entity Framework)」を参照してください。

ADO.NET プロバイダーを使用するアプリケーションの注意点

SqlClient などの ADO.NET プロバイダーを使用すると、データ ソースに対するクエリを実行して表形式のデータを取得できます。 データを ADO.NET DataSet に読み込むこともできます。 以下は、既存の ADO.NET プロバイダーを使用するアプリケーションをアップグレードする場合の注意点です。

  • データ リーダーを使用して表形式のデータを表示している場合
    EntityClient プロバイダーを使用して Entity SQL クエリを実行して、返された EntityDataReader オブジェクトを列挙処理することも考えられますが、 この方法を使用するのは、データ リーダーを使用して表形式のデータを表示するアプリケーションで、データをオブジェクトに具体化したり、変更を追跡したり、更新を行ったりするための Entity Framework の機能が不要である場合だけにしてください。 データ ソースを更新する既存のデータ アクセス コードも引き続き使用できますが、EntityConnection の StoreConnection プロパティから既存の接続にアクセスできます。 詳細については、「Entity Framework 用の EntityClient プロバイダー」を参照してください。

  • DataSet を使用している場合
    Entity Framework は、メモリへの保持、変更の追跡、データ バインド、オブジェクトの XML データとしてのシリアル化など、DataSet によって提供される機能の多くを提供します。 詳細については、「オブジェクトの使用 (Entity Framework)」を参照してください。

    アプリケーションで必要な DataSet の機能が Entity Framework によって提供されない場合も、LINQ to DataSet を使用して LINQ クエリを活用することができます。 詳細については、「LINQ to DataSet」を参照してください。

データをコントロールにバインドするアプリケーションの注意点

.NET Framework では、データをデータ ソース (DataSet や ASP.NET データ ソース コントロールなど) にカプセル化して、それらのデータ コントロールにユーザー インターフェイス要素をバインドすることができます。 以下は、コントロールを Entity Framework データにバインドする場合の注意点です。

  • コントロールへのデータ バインド
    概念モデルに対してクエリを実行すると、Entity Framework によって、エンティティ型のインスタンスであるオブジェクトとしてデータが返されます。 それらのオブジェクトは直接コントロールにバインドでき、そのバインドで更新がサポートされます。 したがって、SaveChanges メソッドが呼び出されると、コントロールのデータ (DataGridView の行など) に対する変更が自動的にデータベースに保存されます。

    クエリの結果を列挙して、データ バインドをサポートする DataGridView などのコントロールにデータを表示するアプリケーションは、そのコントロールを ObjectQuery の結果にバインドするように変更できます。

    詳細については、「コントロールへのオブジェクトのバインド (Entity Framework)」を参照してください。

  • ASP.NET データ ソース コントロール
    Entity Framework には、ASP.NET Web アプリケーションのデータ バインドを単純化するために作られたデータ ソース コントロールが含まれています。 詳細については、「Entity Framework データ ソース コントロール」を参照してください。

その他の注意点

以下は、特定の種類のアプリケーションを Entity Framework に移行する場合の注意点です。

  • データ サービスを公開するアプリケーション
    Windows Communication Foundation (WCF) をベースとする Web サービスやアプリケーションは、XML 要求/応答メッセージ形式を使用して基になるデータ ソースのデータを公開します。 Entity Framework では、バイナリ、XML、または WCF データ コントラクトのシリアル化を使用してエンティティ オブジェクトをシリアル化できます。 バイナリ シリアル化と WCF シリアル化ではオブジェクト グラフの完全なシリアル化がサポートされています。 詳細については、「N 層アプリケーションのビルド (Entity Framework)」を参照してください。

  • XML データを使用するアプリケーション
    オブジェクトのシリアル化を使用すると、 XML データを使用するアプリケーション (AJAX ベースのインターネット アプリケーションなど) にデータを提供する Entity Framework データ サービスを作成できます。 このような場合は ADO.NET Data Services の使用を検討してください。 これらのデータ サービスは Entity Data Model に基づいており、GET、PUT、POST などの標準の Representational State Transfer (REST) HTTP アクションを使用したエンティティ データへの動的アクセスを提供します。 詳細については、「ADO.NET Data Services」を参照してください。

    Entity Framework はネイティブ XML データ型をサポートしていません。 そのため、XML 列を持つテーブルにエンティティをマップすると、その XML 列に対応するエンティティ プロパティは文字列になります。 このような場合は、オブジェクトを切断して XML としてシリアル化することができます。 詳細については、「オブジェクトのシリアル化 (Entity Framework)」を参照してください。

    アプリケーションで XML データのクエリ機能が必要な場合も、LINQ to XML を使用して LINQ クエリを活用することができます。 詳細については、「LINQ to XML」を参照してください。

  • 状態を保持するアプリケーション
    ASP.NET Web アプリケーションでは、Web ページやユーザー セッションの状態を保持しなければならないことがよくあります。 ObjectContext インスタンス内のオブジェクトは、クライアントのビュー ステートやサーバーのセッション状態に格納できます。格納したオブジェクトを取得して新しいオブジェクト コンテキストに再アタッチすることもできます。 詳細については、「オブジェクトのアタッチとデタッチ (Entity Framework)」を参照してください。

参照

概念

配置に関する注意事項 (Entity Framework)
Entity Framework の用語