EntityConnection コンストラクター

定義

名前空間:

System.Data.EntityClient

アセンブリ:

System.Data.Entity.dll

EntityConnection クラスの新しいインスタンスを初期化します。

オーバーロード

EntityConnection()	EntityConnection クラスの新しいインスタンスを初期化します。
EntityConnection(String)	接続文字列に基づいて、EntityConnection クラスの新しいインスタンスを初期化します。
EntityConnection(MetadataWorkspace, DbConnection)	指定した EntityConnection および MetadataWorkspace を使用して、DbConnection クラスの新しいインスタンスを初期化します。

注釈

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

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

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

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

コード例については、「 EntityClient の操作」を参照してください。

EntityConnection()

EntityConnection クラスの新しいインスタンスを初期化します。

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

注釈

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

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

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

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

コード例については、「 EntityClient の操作」を参照してください。

EntityConnection(String)

接続文字列に基づいて、EntityConnection クラスの新しいインスタンスを初期化します。

public:
 EntityConnection(System::String ^ connectionString);

public EntityConnection (string connectionString);

new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnection

Public Sub New (connectionString As String)

パラメーター

connectionString

String

プロバイダー固有の接続文字列。

例外

ArgumentException

無効な接続文字列キーワードが指定されたか、必要な接続文字列キーワードが指定されていません。

注釈

Entity Data Model ツールは、アプリケーションの構成ファイルに格納されている名前付き接続文字列を生成します。 この名前付き接続文字列は、 クラスをインスタンス化EntityConnectionするときに パラメーターconnectionStringの代わりに指定できます。

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

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

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

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

コード例については、「 EntityClient の操作」を参照してください。

EntityConnection(MetadataWorkspace, DbConnection)

指定した EntityConnection および MetadataWorkspace を使用して、DbConnection クラスの新しいインスタンスを初期化します。

public:
 EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);

public EntityConnection (System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);

new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnection

Public Sub New (workspace As MetadataWorkspace, connection As DbConnection)

パラメーター

workspace

MetadataWorkspace

この MetadataWorkspace に関連付けられた EntityConnection。

connection

DbConnection

この EntityConnection オブジェクトの基になるデータ ソース接続。

例外

ArgumentNullException

workspace パラメーターまたは connection パラメーターが null です。

ArgumentException

概念モデルがワークスペースから見つかりません。

- または -

マッピング ファイルがワークスペースから見つかりません。

- または -

ストレージ モデルがワークスペースから見つかりません。

- または -

connection が閉じた状態ではありません。

ProviderIncompatibleException

connection が ADO.NET Entity Framework 互換のプロバイダーからのものではありません。

注釈

このコンストラクターを使用すると、ディスク上のファイル、またはアセンブリの埋め込みリソースからではないメタデータから EntityConnection を作成できます。

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

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

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

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