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) 接受 a MetadataWorkspace 和 a 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) 接受 a MetadataWorkspace 和 a 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 工具 生成存储在应用程序的配置文件中的命名连接字符串。 实例化 connectionString 类时，可以提供命名连接字符串代替 EntityConnection 参数。

为了避免无意中放置对象 System.Data.Common.CommandTrees 并 ObjectContext 与其元数据不同步， EntityConnection 必须锁定其元数据。 锁定元数据后，不允许对连接字符串进行更改。 下面是两种锁定元数据的方案：

• EntityConnection 实例通过无参数构造函数或此构造函数（EntityConnection(String)）构造，该构造函数接受连接字符串。 在这两种情况下，在打开连接之前，可能会多次更改连接字符串。 调用 Open 或 GetMetadataWorkspace 锁定元数据。

• 实例 EntityConnection 通过 EntityConnection(MetadataWorkspace, DbConnection) 接受 a MetadataWorkspace 和 a 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关联的 AEntityConnection。

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)）构造，该构造函数接受 a MetadataWorkspace 和 a DbConnection. 在这种情况下，元数据在构造时被锁定。 不允许对连接字符串进行更改。

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