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 验证概念性模型、存储模型和映射文件是否全部存在。