DbConnection 類別

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

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)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 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()	傳回包含 Component名稱的 String，如果有的話。 不應該覆寫這個方法。 (繼承來源 Component)

事件

Disposed	當呼叫 Dispose() 方法時，就會發生元件。 (繼承來源 Component)
StateChange	當連接的狀態變更時發生。

明確介面實作

IDbConnection.BeginTransaction()	開始資料庫交易。
IDbConnection.BeginTransaction(IsolationLevel)	以指定的隔離等級開始資料庫交易。
IDbConnection.CreateCommand()	建立並傳回與目前連接相關聯的 DbCommand 物件。

擴充方法

ConfigureAwait(IAsyncDisposable, Boolean)

設定如何執行從異步可處置專案傳回的工作等候。

另請參閱

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