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

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

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

构造函数

EntityConnection()	初始化 EntityConnection 类的新实例。
EntityConnection(MetadataWorkspace, DbConnection)	使用指定的 EntityConnection 和 MetadataWorkspace 初始化 DbConnection 类的新实例。
EntityConnection(String)	基于连接字符串初始化 EntityConnection 类的新实例。

属性

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

方法

BeginDbTransaction(IsolationLevel)	在派生类中重写时，启动数据库事务。 (继承自 DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	异步启动数据库事务。 (继承自 DbConnection)
BeginTransaction()	使用基础提供程序开始一个事务。
BeginTransaction(IsolationLevel)	使用基础提供程序开始一个具有指定隔离级别的事务。
BeginTransactionAsync(CancellationToken)	异步开始数据库事务。 (继承自 DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	异步开始数据库事务。 (继承自 DbConnection)
ChangeDatabase(String)	不支持。
ChangeDatabaseAsync(String, CancellationToken)	为打开的连接对象异步更改当前数据库。 (继承自 DbConnection)
Close()	关闭与数据库之间的连接。
CloseAsync()	异步关闭与数据库之间的连接。 (继承自 DbConnection)
CreateBatch()	返回实现 DbBatch 类的提供程序类的一个新实例。 (继承自 DbConnection)
CreateCommand()	在 EntityCommand 设置为此 Connection 的情况下创建 EntityConnection 的新实例。
CreateDbBatch()	在派生类中重写时，返回实现 DbBatch 类的提供程序类的新实例。 (继承自 DbConnection)
CreateDbCommand()	在派生类中重写时，创建并返回与当前连接关联的 DbCommand 对象。 (继承自 DbConnection)
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 DbConnection)
Dispose(Boolean)	释放由 DbConnection 占用的非托管资源，还可以另外再释放托管资源。 (继承自 DbConnection)
DisposeAsync()	异步处置连接对象。 (继承自 DbConnection)
EnlistTransaction(Transaction)	在指定的事务中登记此 EntityConnection。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetMetadataWorkspace()	返回与此 MetadataWorkspace 关联的 EntityConnection。
GetSchema()	返回此 DbConnection 的数据源的架构信息。 (继承自 DbConnection)
GetSchema(String)	通过使用架构名称的指定字符串，返回此 DbConnection 的数据源的架构信息。 (继承自 DbConnection)
GetSchema(String, String[])	通过使用指定字符串作为架构名称，指定字符串数组作为限制值，返回此 DbConnection 的数据源的架构信息。 (继承自 DbConnection)
GetSchemaAsync(CancellationToken)	这是 GetSchema() 的异步版本。 提供程序应使用合适的实现进行重写。 可以选择接受 cancellationToken。 默认实现调用同步 GetSchema() 调用并返回已完成任务。 如果传递到已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchema() 引发的异常将通过任务异常属性传递。 (继承自 DbConnection)
GetSchemaAsync(String, CancellationToken)	这是 GetSchema(String) 的异步版本。 提供程序应使用合适的实现进行重写。 可以选择接受 cancellationToken。 默认实现调用同步 GetSchema(String) 调用并返回已完成任务。 如果传递到已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchema(String) 引发的异常将通过任务异常属性传递。 (继承自 DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	这是 GetSchema(String, String[]) 的异步版本。 提供程序应使用合适的实现进行重写。 可以选择接受 cancellationToken。 默认实现调用同步 GetSchema(String, String[]) 调用并返回已完成任务。 如果传递到已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchema(String, String[]) 引发的异常将通过任务异常属性传递。 (继承自 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()	Open()的异步版本，打开由 ConnectionString指定的设置的数据库连接。 此方法通过 CancellationToken.None 调用虚拟方法 OpenAsync(CancellationToken)。 (继承自 DbConnection)
OpenAsync(CancellationToken)	这是 Open() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性接受取消标记。 默认实现调用同步 Open() 调用并返回已完成任务。 如果传递到已取消的取消标记，则默认实现将返回已取消的 cancellationToken。 Open 引发的异常将通过返回的任务异常属性传递。 在返回的任务完成前，不要调用 DbConnection 对象的其他方法和属性。 (继承自 DbConnection)
ToString()	返回包含 Component 的名称的 String（如果有）。 不应重写此方法。 (继承自 Component)

事件

Disposed	在通过调用 Dispose() 方法释放组件时发生。 (继承自 Component)
StateChange	当连接状态改变时发生。 (继承自 DbConnection)

显式接口实现

IDbConnection.BeginTransaction()	开始一项数据库事务。 (继承自 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	以指定的隔离级别启动数据库事务。 (继承自 DbConnection)
IDbConnection.CreateCommand()	创建并返回与当前连接关联的 DbCommand 对象。 (继承自 DbConnection)

另请参阅

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