方法: クラスライブラリで定義されたモデルを使用する (Entity Data Model ツール)

[アーティクル]
04/19/2011

このトピックでは、Visual Studio 2008 クラスライブラリプロジェクトで定義された概念モデルを使用する方法について説明します。

このトピックの最初の手順では、クラスライブラリで定義された概念モデルを ASP.NET Web サイトプロジェクト以外のプロジェクトから使用する方法について説明します。 2 番目の手順では、クラスライブラリで定義された概念モデルを ASP.NET Web サイトプロジェクトから使用する方法について説明します。

クラスライブラリで定義されたモデルを ASP.NET Web サイトプロジェクト以外のプロジェクトから使用するには

Visual Studio で、Visual C# または Visual Basic クラスライブラリプロジェクトを作成します。

Visual Studio でのプロジェクトの作成については、「方法: ソリューションおよびプロジェクトを作成する」を参照してください。
概念モデルをクラスライブラリプロジェクトに追加します。

新しい概念モデルを作成してプロジェクトに追加する方法については、「方法: 新しい .edmx ファイルを作成する (Entity Data Model ツール)」を参照してください。既存の概念モデルをプロジェクトに追加する方法については、「方法: 既存の .edmx ファイルを追加する (Entity Data Model ツール)」を参照してください。
ASP.NET Web サイトプロジェクトではない新しいプロジェクトを既存のソリューションに追加します。

プロジェクトを既存のソリューションに追加する方法については、「方法: 複数のプロジェクトから成るソリューションを作成する」を参照してください。
新しく追加したプロジェクト (クラスライブラリプロジェクトではない) を右クリックして [参照の追加] をクリックします。

[参照の追加] ダイアログボックスが表示されます。
[参照の追加] ダイアログボックスの [プロジェクト] タブをクリックし、クラスライブラリプロジェクトを選択します。 [OK] をクリックします。
もう一度、新しく追加したプロジェクト (クラスライブラリプロジェクトではない) を右クリックして [参照の追加] をクリックします。
[追加の参照] ダイアログボックスの [.NET] タブをクリックし、[System.Data.Entity] を選択します。 [OK] をクリックします。
クラスライブラリプロジェクトの App.Config ファイルを開きます。

App.Config ファイルの接続文字列のセクションを選択して右クリックし、[コピー] をクリックします。たとえば、次のようなコードをコピーします。

<add name="SchoolEntities" 
           connectionString="metadata=res://*/School.csdl|
                                      res://*/School.ssdl|
                                      res://*/School.msl;
                             provider=System.Data.SqlClient;
                             provider connection string=&quot;
                             Data Source=(local);
                             Initial Catalog=School;
                             Integrated Security=True;
                             MultipleActiveResultSets=True&quot;" 
           providerName="System.Data.EntityClient" />

新しく作成したプロジェクトの App.Config ファイルを開き、コピーした接続文字列情報を <connectionStrings> ノードに貼り付けます。

注 :
プロジェクトに App.Config ファイルがない場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、[追加] をポイントして [新しい項目] をクリックすることによって追加できます。表示されたダイアログボックスから [アプリケーション構成ファイル] を選択し、[OK] をクリックします。

プロジェクトに App.Config ファイルがない場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、[追加] をポイントして [新しい項目] をクリックすることによって追加できます。表示されたダイアログボックスから [アプリケーション構成ファイル] を選択し、[OK] をクリックします。

これで、クラスライブラリプロジェクトで定義されている概念モデルを使用するコードを、新しく追加したプロジェクトで記述できるようになります。

注 :
ソリューションをビルドする前に、新しく追加したプロジェクトをスタートアッププロジェクトとして設定する必要が生じる場合があります。その場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、[スタートアッププロジェクトに設定] をクリックします。

クラスライブラリで定義されたモデルを ASP.NET Web サイトプロジェクトから使用するには

Visual Studio で、Visual C# または Visual Basic クラスライブラリプロジェクトを作成します。

Visual Studio でのプロジェクトの作成については、「方法: ソリューションおよびプロジェクトを作成する」を参照してください。
概念モデルをクラスライブラリプロジェクトに追加します。

新しい概念モデルを作成してプロジェクトに追加する方法については、「方法: 新しい .edmx ファイルを作成する (Entity Data Model ツール)」を参照してください。既存の概念モデルをプロジェクトに追加する方法については、「方法: 既存の .edmx ファイルを追加する (Entity Data Model ツール)」を参照してください。
ASP.NET Web サイトプロジェクトを既存のソリューションに追加します。

プロジェクトを既存のソリューションに追加する方法については、「方法: 複数のプロジェクトから成るソリューションを作成する」を参照してください。
ASP.NET Web サイトプロジェクトを右クリックして [参照の追加] をクリックします。

[参照の追加] ダイアログボックスが表示されます。
[追加の参照] ダイアログボックスの [.NET] タブをクリックし、[System.Data.Entity] を選択します。 [OK] をクリックします。
次に、ASP.NET Web サイトプロジェクトからクラスライブラリプロジェクトを参照します。これを実行するには、次の 2 つの方法があります。
1. ソリューションエクスプローラーで、ASP.NET Web サイトプロジェクトを右クリックして [参照の追加] をクリックします。
  
  [参照の追加] ダイアログボックスが表示されます。
2. [参照の追加] ダイアログボックスの [プロジェクト] タブをクリックし、クラスライブラリプロジェクトを選択します。 [OK] をクリックします。
または
1. ソリューションエクスプローラーで、クラスライブラリプロジェクトを右クリックして [ビルド] をクリックします。
  
  クラスライブラリアセンブリがプロジェクトの bin\Debug フォルダーに追加されます。
2. ASP.NET Web サイトプロジェクトを右クリックして [ASP.NET フォルダーの追加] をクリックします。 [Bin] を選択します。
  
  Bin フォルダーがプロジェクトに追加されます。
3. Windows エクスプローラーで、クラスライブラリプロジェクトの bin\Debug フォルダーに移動します。プロジェクトアセンブリ (<project_name>.dll ファイル) を右クリックして [コピー] をクリックします。
4. ソリューションエクスプローラーで、ASP.NET Web サイトプロジェクトの下にある Bin フォルダーを右クリックして [貼り付け] をクリックします。
次に、モデルファイルとマッピングファイルを ASP.NET Web サイトプロジェクトで使用できるようにします。そのためには、次の手順に従って、モデルファイルとマッピングファイルをクラスライブラリアセンブリにリソースとして組み込みます。別の方法については、このトピックの最後に記載されている手順 (「ASP.NET Web サイトプロジェクトへのマッピングファイルとメタデータファイルのコピー」) を参照してください。
1. クラスライブラリプロジェクトの App.Config ファイルを開きます。
2. 接続文字列情報を選択して右クリックし、[コピー] をクリックします。たとえば、次のようなコードをコピーします。
```
<add name="SchoolEntities" 
           connectionString="metadata=res://*/School.csdl|
                                      res://*/School.ssdl|
                                      res://*/School.msl;
                             provider=System.Data.SqlClient;
                             provider connection string=&quot;
                             Data Source=(local);
                             Initial Catalog=School;
                             Integrated Security=True;
                             MultipleActiveResultSets=True&quot;" 
           providerName="System.Data.EntityClient" />
```
3. ASP.NET Web サイトプロジェクトの Web.config ファイルを開き、コピーした接続文字列情報を <connectionStrings> ノードに貼り付けます。

これで、クラスライブラリプロジェクトで定義されている概念モデルを使用するコードを ASP.NET Web サイトプロジェクトで記述できるようになります。

注 :
ソリューションをビルドする前に、新しく追加したプロジェクトをスタートアッププロジェクトとして設定する必要が生じる場合があります。その場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、[スタートアッププロジェクトに設定] をクリックします。

ASP.NET Web サイトプロジェクトへのマッピングファイルとメタデータファイルのコピー

ここでは、ASP.NET Web サイトプロジェクトにモデルファイルとマッピングファイルをコピーするための 2 つの方法について説明します。ここで説明するどちらの方法も、上記の手順の手順 7. の代わりに使用できます。最初の手順では、ファイルを ASP.NET Web サイトプロジェクトの Bin フォルダーにコピーする方法を説明し、2 番目の手順では、ファイルを App_Data フォルダーにコピーする方法を説明します。これらのいずれかの方法を使用する場合は、モデルファイルとマッピングファイルをクラスライブラリアセンブリにリソースとして組み込まないでください。

ASP.NET Web サイトプロジェクトの Bin フォルダーにモデルファイルとマッピングファイルをコピーするには

クラスライブラリプロジェクトの .edmx ファイルをダブルクリックします。 ADO.NET Entity Data Model デザイナー (エンティティデザイナー) で .edmx ファイルが開きます。
デザイン画面の空の領域を右クリックし、[プロパティ] をクリックします。
[プロパティ] ウィンドウで、[メタデータ成果物の処理] プロパティの値を [出力ディレクトリにコピー] に設定します。この値を選択すると、エンティティデザイナーによって、クラスライブラリの App.Config ファイル内の接続文字列が相対ファイルパスに変更されます。
ソリューションエクスプローラーで、クラスライブラリプロジェクトを右クリックして [ビルド] をクリックします。
Windows エクスプローラーで、クラスライブラリの出力ディレクトリ (bin\Debug フォルダー) に移動し、.csdl、.ssdl、および .msl ファイルをコピーします。

ASP.NET Web サイトプロジェクトの下にある Bin フォルダーを右クリックして [貼り付け] をクリックします。

注 :
プロジェクトに Bin フォルダーがない場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、[ASP.NET フォルダーの追加] をポイントして [Bin] をクリックすることによって追加できます。

クラスライブラリプロジェクトの App.Config ファイルを開きます。接続文字列情報を選択して右クリックし、[コピー] をクリックします。
ASP.NET Web サイトプロジェクトの Web.config ファイルを開き、コピーした接続文字列情報を <connectionStrings> ノードに貼り付けます。

接続文字列のメタデータエントリを、先頭に ~\bin\ が付くように変更します。たとえば、コピーして変更した接続文字列のエントリは次のようになります。

<add name="SchoolEntities" 
         connectionString="metadata=~\bin\School.csdl|
                                    ~\bin\School.ssdl|
                                    ~\bin\School.msl;
                           provider=System.Data.SqlClient;
                           provider connection string=&quot;
                           Data Source=(local);
                           Initial Catalog=School;
                           Integrated Security=True;
                           MultipleActiveResultSets=True&quot;" 
         providerName="System.Data.EntityClient" />

ASP.NET Web サイトの App_Data フォルダーにモデルファイルとマッピングファイルをコピーするには

モデルファイルとマッピングファイルを App_Data フォルダーにコピーする手順は、Bin フォルダーにコピーする手順とほとんど同様です。ただし、以下の 2 つの重要な違いがあります。
- .csdl、.ssdl、および .msl ファイルをコピーするフォルダーは、Bin フォルダーではなく、ASP.NET Web サイトプロジェクトの App_Data フォルダーにします (上記の手順 6.)。
  
  メモプロジェクトに App_Data フォルダーがない場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、[ASP.NET フォルダーの追加] をポイントして [App_Data] をクリックすることによって追加できます。
- クラスライブラリの App.Config ファイルから ASP.NET Web サイトの Web.config ファイルに接続文字列情報をコピーした後 (上記の手順 7. および 8.)、メタデータエントリを変更して先頭に付ける文字列は |DataDirectory| にします。たとえば、コピーして変更した接続文字列のエントリは次のようになります。
```
<add name="SchoolEntities" 
         connectionString="metadata=|DataDirectory|\School.csdl|
                                    |DataDirectory|\School.ssdl|
                                    |DataDirectory|\School.msl;
                           provider=System.Data.SqlClient;
                           provider connection string=&quot;
                           Data Source=(local);
                           Initial Catalog=School;
                           Integrated Security=True;
                           MultipleActiveResultSets=True&quot;" 
         providerName="System.Data.EntityClient" />
```

参照

その他のリソース

Entity Data Model ツールを使用した配置タスク
 Entity Data Model ツールのタスク
 Entity Data Model ツールのシナリオ
 Connection Strings

方法: クラス ライブラリで定義されたモデルを使用する (Entity Data Model ツール)

クラス ライブラリで定義されたモデルを ASP.NET Web サイト プロジェクト以外のプロジェクトから使用するには

クラス ライブラリで定義されたモデルを ASP.NET Web サイト プロジェクトから使用するには

ASP.NET Web サイト プロジェクトへのマッピング ファイルとメタデータ ファイルのコピー

ASP.NET Web サイト プロジェクトの Bin フォルダーにモデル ファイルとマッピング ファイルをコピーするには

ASP.NET Web サイトの App_Data フォルダーにモデル ファイルとマッピング ファイルをコピーするには

参照

その他のリソース

その他のリソース

方法: クラスライブラリで定義されたモデルを使用する (Entity Data Model ツール)

クラスライブラリで定義されたモデルを ASP.NET Web サイトプロジェクト以外のプロジェクトから使用するには

クラスライブラリで定義されたモデルを ASP.NET Web サイトプロジェクトから使用するには

ASP.NET Web サイトプロジェクトへのマッピングファイルとメタデータファイルのコピー

ASP.NET Web サイトプロジェクトの Bin フォルダーにモデルファイルとマッピングファイルをコピーするには

ASP.NET Web サイトの App_Data フォルダーにモデルファイルとマッピングファイルをコピーするには