EntityConnection.GetMetadataWorkspace メソッド

定義

名前空間:

System.Data.EntityClient

アセンブリ:

System.Data.Entity.dll

重要

この API は CLS 準拠ではありません。

この MetadataWorkspace に関連付けられている EntityConnection を返します。

public:
 System::Data::Metadata::Edm::MetadataWorkspace ^ GetMetadataWorkspace();

[System.CLSCompliant(false)]
public System.Data.Metadata.Edm.MetadataWorkspace GetMetadataWorkspace ();

[<System.CLSCompliant(false)>]
member this.GetMetadataWorkspace : unit -> System.Data.Metadata.Edm.MetadataWorkspace

Public Function GetMetadataWorkspace () As MetadataWorkspace

戻り値

MetadataWorkspace

この MetadataWorkspace に関連付けられている EntityConnection。

属性

CLSCompliantAttribute

例外

MetadataException

インライン接続文字列に無効な Metadata キーワード値が含まれています。

注釈

MetadataWorkspace クラスが作成されると、EntityConnection が自動的に作成されます。 作成プロセスで、メタデータ固有の例外がスローされることがあります。 メタデータがメモリに読み込まれると、Entity Data Model (EDM) アプリケーションは、そのメタデータを使用して、基になるデータ ソースに関する情報にアクセスします。 詳細については、「 ADO.NET メタデータ」を参照してください。

System.Data.Common.CommandTrees や ObjectContext などのオブジェクトが不注意でメタデータと同期しなくなるのを防ぐため、EntityConnection でそのメタデータをロックする必要があります。 メタデータがロックされると、接続文字列に変更を加えることができなくなります。 メタデータがロックされる 2 つのシナリオを次に示します。

• インスタンスは EntityConnection 、パラメーターなしのコンストラクターまたは接続文字列を受け入れるコンストラクターを EntityConnection(String) 介して構築されます。 いずれの場合も、接続が開かれる前に接続文字列が複数回変更される可能性があります。 Open または GetMetadataWorkspace では、メタデータがロックされます。

• EntityConnection と EntityConnection(MetadataWorkspace, DbConnection) を受け入れる MetadataWorkspace コンストラクターによって、DbConnection インスタンスが構築された場合。 この場合、メタデータは構築時にロックされます。 接続文字列に変更を加えることはできません。

メタデータが読み込まれると、EntityConnection は、概念モデル、ストレージ モデル、およびマッピング ファイルがすべて存在することを確認します。