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 必须锁定对象的元数据。 锁定元数据后，不允许对连接字符串做出任何更改。 下面是锁定元数据的两种方案：

• 实例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 必须锁定对象的元数据。 锁定元数据后，不允许对连接字符串做出任何更改。 下面是锁定元数据的两种方案：

• 实例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

提供的连接字符串关键字无效，或未提供所需的连接字符串关键字。

注解

实体数据模型工具生成存储在应用程序的配置文件中的命名连接字符串。 实例化 EntityConnection 类时，可以提供名为 连接字符串 代替 connectionString 参数。

为了避免无意使对象（如 System.Data.Common.CommandTrees 和 ObjectContext）与其元数据失去同步，EntityConnection 必须锁定对象的元数据。 锁定元数据后，不允许对连接字符串做出任何更改。 下面是锁定元数据的两种方案：

• 实例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 必须锁定对象的元数据。 锁定元数据后，不允许对连接字符串做出任何更改。 下面是锁定元数据的两种方案：

• 实例EntityConnection是通过无参数构造函数或通过EntityConnection(String)接受连接字符串的构造函数构造的。 在任何一种情况下，连接字符串可能在打开连接前进行多次更改。 调用 Open 或 GetMetadataWorkspace 锁定元数据。

• EntityConnection 实例通过构造函数（EntityConnection(MetadataWorkspace, DbConnection)）进行构造，此构造函数接受 MetadataWorkspace 和 DbConnection。 在这种情况下，元数据在构造时锁定。 不允许对连接字符串做出任何更改。

加载元数据后，EntityConnection 验证概念性模型、存储模型和映射文件是否全部存在。