接続文字列 (Entity Framework)
接続文字列には、データ プロバイダからデータ ソースにパラメータとして渡す初期化情報が含まれています。接続文字列は接続を開くときに解析され、その構文はデータ プロバイダによって異なります。Entity Framework で使用される接続文字列には、Entity Framework のサポート基盤である ADO.NET データ プロバイダへの接続に使用される情報が含まれています。また、必要な Entity Data Model (EDM) のマッピングとメタデータに関する情報も含まれています。
接続文字列は、EDM のマッピングとメタデータにアクセスしてデータ ソースに接続する際に EntityClient プロバイダによって使用されます。接続文字列へのアクセスや接続文字列の設定は、EntityConnection の ConnectionString プロパティを使用して行います。EntityConnectionStringBuilder クラスを使用すると、接続文字列内のパラメータの構築やこれらへのアクセスをプログラムで行えます。詳細については、「EntityConnection の接続文字列を作成する方法 (Entity Framework)」を参照してください。
Entity Data Model ツールでは、アプリケーションの構成ファイルに格納される接続文字列が生成されます。オブジェクト クエリの作成時に、ObjectContext によってこの接続情報が自動的に取得されます。ObjectContext インスタンスで使用される EntityConnection には、Connection プロパティからアクセスできます。詳細については、「Object Services の接続の管理 (Entity Framework)」を参照してください。
接続文字列パラメータ
接続文字列の形式は、キーと値のパラメータのペアをセミコロンで区切ったリストです。
keyword1=value; keyword2=value;
それぞれのキーワードと値の関連付けには、等号 (=) が使用されます。キーワードの大文字と小文字は区別されません。また、キーと値のペア間のスペースは無視されます。ただし、値の大文字と小文字を区別するかどうかはデータ ソースにより異なる場合があります。値にセミコロン、単一引用符、または二重引用符が含まれている場合は、必ず二重引用符で囲む必要があります。ConnectionString のキーワード値に有効な名前を次の表に示します。
| キーワード | 説明 |
|---|---|
Provider |
Name キーワードが指定されていない場合に必要です。基になるプロバイダの DbProviderFactory オブジェクトを取得するために使用されるプロバイダ名です。この値は定数です。 Name キーワードがエンティティ接続文字列に含まれていない場合、Provider キーワードの空でない値が必要になります。このキーワードは Name キーワードと同時に指定できません。 |
Provider Connection String |
省略可能です。基になるデータ ソースに渡される、プロバイダ固有の接続文字列を指定します。この接続文字列は、データ プロバイダの有効なキーワード/値ペアを使用して表されます。無効な Provider Connection String がデータ ソースによって評価されると、ランタイム エラーが発生します。 このキーワードは Name キーワードと同時に指定できません。 Provider Connection String の値は、引用符で囲む必要があります。次に例を示します。
次に誤った例を示します。
|
Metadata |
Name キーワードが指定されていない場合に必要です。メタデータとマッピング情報の検索対象となるディレクトリ、ファイル、およびリソースの場所をパイプで区切って指定したリストです。次に例を示します。
パイプ区切り記号の両側の空白は無視されます。 このキーワードは Name キーワードと同時に指定できません。 |
Name |
アプリケーションは、オプションで、必要なキーワード/値接続文字列値を提供する接続名をアプリケーション構成ファイル内で指定できます。その場合は、接続文字列内に値を直接記述することはできません。Name キーワードは、構成ファイル内で使用できません。 Name キーワードが接続文字列に含まれていない場合、Provider キーワードの空でない値が必要になります。 このキーワードは他のすべての接続文字列キーワードと同時に指定できません。 |
アプリケーション構成ファイルに格納された AdventureWorks Sales Model の接続文字列の例を次に示します。
<connectionStrings>
<add name="AdventureWorksEntities"
connectionString="metadata=.\AdventureWorks.csdl|.\AdventureWorks.ssdl|.\AdventureWorks.msl;
provider=System.Data.SqlClient;provider connection string='Data Source=localhost;
Initial Catalog=AdventureWorks;Integrated Security=True;Connection Timeout=60;
multipleactiveresultsets=true'" providerName="System.Data.EntityClient" />
<add name="NorthwindEntities" connectionString="metadata=.\Northwind.csdl|.\Northwind.ssdl.\Northwind.msl;
provider=System.Data.SqlClient;provider connection string='Data Source=localhost;
Initial Catalog=Northwind;Integrated Security=True;MultipleActiveResultSets=True'"
providerName="System.Data.EntityClient" />
</connectionStrings>
EDM のマッピングとメタデータの場所
Metadata パラメータには、EntityClient プロバイダが EDM マッピング ファイルおよびメタデータ ファイルを検索するための場所のリストが格納されます。多くの場合、マッピング ファイルとメタデータ ファイルは、アプリケーション実行可能ファイルと同じディレクトリに配置されます。これらのファイルは、特定の場所に配置することも組み込みリソースとしてアプリケーションに含めることもできます。
組み込みリソースは次のように指定します。
Metadata=res://<assemblyFullName>/<resourceName>.
組み込みリソースの場所を定義するには、次のオプションを使用できます。
オプション |
説明 |
assemblyFullName |
リソースが組み込まれたアセンブリの完全な名前。この名前には、次のように単純な名前、バージョン名、サポートされるカルチャ、および公開キーが含まれます。
リソースは、アプリケーションからアクセスできる任意のアセンブリに組み込むことができます。 assemblyFullName にワイルドカード (*) を指定すると、Entity Framework ランタイムでは、次の場所のリソースがこの順序で検索されます。
ファイルが上記のどの場所にもない場合は、例外がスローされます。 .gif "Note") メモ
ワイルドカード (*) を使用する場合、Entity Framework では、正しい名前のリソースを見つけるためにすべてのアセンブリを調べる必要があります。パフォーマンスを向上させるには、ワイルドカードではなくアセンブリ名を指定してください。
|
resourceName |
AdvendtureWorksModel.csdl などの含まれるリソースの名前。メタデータ サービスでは、拡張子が .csdl、.ssdl、または .msl のいずれかであるファイルまたはリソースのみが検索されます。resourceName を指定しない場合は、すべての EDM リソースが読み込まれます。リソースには、アセンブリ内で一意の名前を付ける必要があります。同じ名前が付けられた複数のファイルがアセンブリ内の異なるディレクトリで定義されている場合、resourceName には、リソースの名前の前にフォルダ構造を含める必要があります (FolderName.FileName.csdl など)。 assemblyFullName にワイルドカード (*) を指定した場合、resourceName は不要です。 |
[!メモ]
パフォーマンスを向上させるには、リソースを呼び出し側のアセンブリに組み込んでください。ただし、呼び出し側のアセンブリ内の基になるマッピング ファイルとメタデータ ファイルへの参照が存在しない Web 以外のシナリオの場合は除きます。
次の例では、呼び出し側のアセンブリ、参照アセンブリ、およびアプリケーションの bin ディレクトリ内のその他のアセンブリに存在するすべての EDM メタデータ成果物を読み込みます。
Metadata=res://*/
次の例では、model.csdl ファイルを AdventureWorks アセンブリから読み込み、model.ssdl ファイルと model.msl ファイルを実行中のアプリケーションの既定のディレクトリから読み込みます。
Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.csdl|model.ssdl|model.msl
次の例では、指定した 3 つのリソースを特定のアセンブリから読み込みます。
Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.csdl|
res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.ssdl|
res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.msl
次の例では、拡張子が .csdl、.msl、および .ssdl であるすべての組み込みリソースをアセンブリから読み込みます。
Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/
次の例では、相対ファイル パスと "datadir\metadata\" 内のすべてのリソースを読み込まれたアセンブリの場所から読み込みます。
Metadata=datadir\metadata\
次の例では、相対ファイル パス内のすべてのリソースを読み込まれたアセンブリの場所から読み込みます。
Metadata=.\
|DataDirectory| 置換文字列と Web アプリケーション ルート演算子 (~) のサポート
DataDirectory と ~ 演算子は、Metadata キーワードと Provider Connection String キーワードの一部として ConnectionString で使用されます。EntityConnection によって、DataDirectory と ~ 演算子がそれぞれ MetadataWorkspace とストア プロバイダに転送されます。
| 用語 | 説明 |
|---|---|
|DataDirectory| |
マッピング ファイルとメタデータ ファイルの相対パスに解決されます。この値は、 "DataDirectory" という名前の物理ディレクトリをメタデータ パスのリストのメンバとして渡す必要がある場合は、名前の片側または両側に空白を追加します ( |
~ |
Web アプリケーション ルートに解決されます。先頭の ~ 文字は、有効なローカル サブディレクトリを表すこともありますが、常に Web アプリケーション ルート演算子 (~) として解釈されます。このようなローカル サブディレクトリを参照するには、ユーザーが明示的に |
DataDirectory と ~ 演算子は、パスの先頭にのみ指定する必要があります。その他の位置では解決されません。Entity Framework では、~/data の解決は試行されますが、/data/~ は物理パスとして処理されます。
DataDirectory または ~ 演算子で始まるパスは、DataDirectory と ~ 演算子の分岐の外側の物理パスには解決できません。たとえば、パス ~、~/data、~/bin/Model/SqlServer は解決されます。パス ~/.. や ~/../other は解決できません。
DataDirectory と ~ 演算子は、|DataDirectory|\Model や ~/bin/Model など、サブディレクトリが含まれるように拡張できます。
DataDirectory 置換文字列と ~ 演算子の解決は非再帰型です。たとえば、DataDirectory に ~ 文字が含まれる場合は、例外が発生します。これにより、無限再帰が回避されます。
参照
概念
配置に関する注意事項 (Entity Framework)
Object Services の接続の管理 (Entity Framework)
その他のリソース
Entity Services とデータ プロバイダ (Entity Framework)
接続およびトランザクションの管理 (Entity Framework タスク)
接続文字列 (ADO.NET)