DbConnection 类

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DbConnection.cs

定义数据库连接的核心行为，并为特定于数据库的连接提供基类。

public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection

public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable

继承

Object

MarshalByRefObject

Component

DbConnection

派生

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

实现

IDisposable IDbConnection IAsyncDisposable

实施者说明

从 DbConnection继承时，必须重写以下成员：Close()、BeginDbTransaction(IsolationLevel)、ChangeDatabase(String)、CreateDbCommand()、Open()和 StateChange。 还必须提供以下属性：ConnectionString、Database、DataSource、ServerVersion和 State。

构造函数

DbConnection()

初始化 DbConnection 类的新实例。

属性

CanCreateBatch	获取一个值，该值指示此 DbConnection 实例是否支持 DbBatch 类。
CanRaiseEvents	获取一个值，该值指示组件是否可以引发事件。 (继承自 Component)
ConnectionString	在派生类中重写时，获取或设置用于打开连接的字符串。
ConnectionTimeout	获取在终止尝试并生成错误之前建立连接的时间（以秒为单位）。
Container	获取包含 Component的 IContainer。 (继承自 Component)
Database	在派生类中重写时，在打开连接后获取当前数据库的名称，或者在打开连接之前在连接字符串中指定的数据库名称。
DataSource	在派生类中重写时，获取要连接到的数据库服务器的名称。
DbProviderFactory	获取此 DbConnection的 DbProviderFactory。
DesignMode	获取一个值，该值指示 Component 当前是否处于设计模式。 (继承自 Component)
Events	获取附加到此 Component的事件处理程序的列表。 (继承自 Component)
ServerVersion	在派生类中重写时，获取一个字符串，表示对象连接到的服务器的版本。
Site	获取或设置 Component的 ISite。 (继承自 Component)
State	获取描述连接状态的字符串。

方法

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

事件

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

显式接口实现

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

扩展方法

ConfigureAwait(IAsyncDisposable, Boolean)

配置如何执行从异步可释放项返回的任务的 await。

另请参阅

• DbProviderFactories （ADO.NET）
• ADO.NET 概述