DbConnection 类

定义

定义数据库连接的核心行为,并为数据库专用连接提供基类。

public ref class DbConnection abstract : IDisposable
public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbConnection
public abstract class DbConnection : IDisposable
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbConnection
type DbConnection = class
    interface IDisposable
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable
type DbConnection = class
    interface IDbConnection
    interface IDisposable
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
Public MustInherit Class DbConnection
Implements IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable
Public MustInherit Class DbConnection
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection
继承
DbConnection
继承
派生
实现

实施者说明

DbConnection继承时,必须重写以下成员:Close()、、BeginDbTransaction(IsolationLevel)ChangeDatabase(String)CreateDbCommand()Open()StateChange。 还必须提供以下属性:ConnectionString、、DatabaseDataSourceServerVersionState

构造函数

DbConnection()

初始化 DbConnection 类的新实例。

属性

CanCreateBatch

获取一个值,该值指示此 DbConnection 是否支持 DbBatch 类。

CanRaiseEvents

获取一个指示组件是否可以引发事件的值。

(继承自 Component)
ConnectionString

在派生类中重写时,获取或设置用于打开连接的字符串。

ConnectionTimeout

获取在建立连接时终止尝试并生成错误之前所等待的时间(以秒为单位)。

Container

获取包含 IContainerComponent

(继承自 Component)
Database

在派生类中重写时,在连接打开之后获取当前数据库的名称,或者在连接打开之前获取连接字符串中指定的数据库名。

DataSource

在派生类中重写时,获取要连接的数据库服务器的名称。

DbProviderFactory

获取此 DbProviderFactoryDbConnection

DesignMode

获取一个值,用以指示 Component 当前是否处于设计模式。

(继承自 Component)
Events

获取附加到此 Component 的事件处理程序的列表。

(继承自 Component)
ServerVersion

在派生类中重写时,获取表示对象所连接到的服务器的版本的字符串。

Site

获取或设置 ComponentISite

(继承自 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()

执行与释放或重置非托管资源关联的应用程序定义的任务。

Dispose()

释放由 Component 使用的所有资源。

(继承自 Component)
Dispose(Boolean)

释放由 DbConnection 占用的非托管资源,还可以另外再释放托管资源。

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()

返回表示当前对象的字符串。

(继承自 Object)
ToString()

返回包含 Component 的名称的 String(如果有)。 不应重写此方法。

(继承自 Component)

事件

Disposed

在通过调用 Dispose() 方法释放组件时发生。

(继承自 Component)
StateChange

当连接状态改变时发生。

显式接口实现

IDbConnection.BeginTransaction()

开始一项数据库事务。

IDbConnection.BeginTransaction(IsolationLevel)

以指定的隔离级别启动数据库事务。

IDbConnection.CreateCommand()

创建并返回与当前连接关联的 DbCommand 对象。

扩展方法

ConfigureAwait(IAsyncDisposable, Boolean)

配置如何执行从异步可处置项返回的任务的等待。

适用于

另请参阅