EntityConnection 类

定义

命名空间:

System.Data.EntityClient

程序集:

System.Data.Entity.dll

包含对概念模型和数据源连接的引用。 无法继承此类。

public ref class EntityConnection sealed : System::Data::Common::DbConnection

public sealed class EntityConnection : System.Data.Common.DbConnection

type EntityConnection = class
    inherit DbConnection

Public NotInheritable Class EntityConnection
Inherits DbConnection

继承

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

注解

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

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

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

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

有关代码示例，请参阅 使用 EntityClient。

构造函数

名称	说明
EntityConnection()	初始化 EntityConnection 类的新实例。
EntityConnection(MetadataWorkspace, DbConnection)	使用指定的 EntityConnection 和 MetadataWorkspace初始化 DbConnection 类的新实例。
EntityConnection(String)	根据连接字符串初始化 EntityConnection 类的新实例。

属性

名称	说明
CanRaiseEvents	获取一个值，该值指示组件是否可以引发事件。 (继承自 Component)
ConnectionString	获取或设置 EntityConnection 连接字符串。
ConnectionTimeout	获取在尝试建立连接之前尝试建立连接并生成错误时等待的秒数。
Container	IContainer获取包含 .Component (继承自 Component)
Database	获取当前数据库的名称，或打开连接后将使用的数据库。
DataSource	获取要连接到的数据源的名称或网络地址。
DbProviderFactory	获取此DbProviderFactory对象的值DbConnection。 (继承自 DbConnection)
DesignMode	获取一个值，该值指示当前是否 Component 处于设计模式。 (继承自 Component)
Events	获取附加到此 Component对象的事件处理程序的列表。 (继承自 Component)
ServerVersion	获取一个字符串，其中包含客户端连接到的数据源的版本。
Site	获取或设置 ISite 的 Component。 (继承自 Component)
State	获取 ConnectionState 基础提供程序的属性（如果 EntityConnection 打开）。 否则返回 Closed。
StoreConnection	提供对对象使用 EntityConnection 的基础数据源连接的访问权限。

方法

名称	说明
BeginDbTransaction(IsolationLevel)	在派生类中重写时，启动数据库事务。 (继承自 DbConnection)
BeginTransaction()	使用基础提供程序开始事务。
BeginTransaction(IsolationLevel)	使用基础提供程序以指定的隔离级别开始事务。
ChangeDatabase(String)	不支持。
Close()	关闭与数据库的连接。
CreateCommand()	创建一个新实例，并将该Connection实例EntityCommand设置为此EntityConnection实例。
CreateDbCommand()	在派生类中重写时，创建并返回 DbCommand 与当前连接关联的对象。 (继承自 DbConnection)
CreateObjRef(Type)	创建一个对象，其中包含生成用于与远程对象通信的代理所需的所有相关信息。 (继承自 MarshalByRefObject)
EnlistTransaction(Transaction)	在指定的事务中登记此项 EntityConnection 。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetMetadataWorkspace()	返回 MetadataWorkspace 与此 EntityConnection关联的值。
GetSchema()	返回此 DbConnection数据源的架构信息。 (继承自 DbConnection)
GetSchema(String, String[])	使用架构名称的指定字符串和限制值的指定字符串数组返回此 DbConnection 数据源的架构信息。 (继承自 DbConnection)
GetSchema(String)	使用架构名称的指定字符串返回此 DbConnection 数据源的架构信息。 (继承自 DbConnection)
GetService(Type)	返回一个对象，该对象表示服务由 Component 或其 Container提供的服务。 (继承自 Component)
GetType()	获取当前实例的 Type。 (继承自 Object)
InitializeLifetimeService()	获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	引发 StateChange 事件。 (继承自 DbConnection)
Open()	通过调用基础数据提供程序 Open 的方法建立与数据源的连接。
OpenAsync()	异步版本的 ，它使用 <a1/> 指定的设置打开数据库连接。 此方法使用 CancellationToken.None 调用虚拟方法 OpenAsync(CancellationToken) 。 (继承自 DbConnection)
OpenAsync(CancellationToken)	这是 .的 Open()异步版本。 提供程序应使用适当的实现替代。 可以选择遵循取消令牌。 默认实现调用同步 Open() 调用并返回已完成的任务。 如果传递已取消的 cancellationToken，则默认实现将返回已取消的任务。 Open 引发的异常将通过返回的任务异常属性进行通信。 在返回的任务完成之前，请勿调用对象的其他方法和属性 DbConnection 。 (继承自 DbConnection)
ToString()	返回包含 String 的名称 Component（如果有）。 不应重写此方法。 (继承自 Component)

活动

名称	说明
Disposed	当组件通过对方法的调用 Dispose() 释放时发生。 (继承自 Component)
StateChange	在连接状态发生更改时发生。 (继承自 DbConnection)

显式接口实现

名称	说明
IDbConnection.BeginTransaction()	开始数据库事务。 (继承自 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	使用指定的隔离级别开始数据库事务。 (继承自 DbConnection)
IDbConnection.CreateCommand()	创建并返回与 DbCommand 当前连接关联的对象。 (继承自 DbConnection)

另请参阅

• EntityClient Provider for Entity Framework
• 连接字符串