DbConnection 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義資料庫連線的核心行為,並為資料庫特定連線提供基底類別。
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、 Database、、 DataSource、 ServerVersion和 State。
建構函式
DbConnection() |
初始化 DbConnection 類別的新執行個體。 |
屬性
CanCreateBatch |
取得值,指出這個 DbConnection 執行個體是否支援 DbBatch 類別。 |
CanRaiseEvents |
取得值,指出元件是否能引發事件。 (繼承來源 Component) |
ConnectionString |
當在衍生類別中覆寫時,取得或設定用於開啟連線的字串。 |
ConnectionTimeout |
取得在終止嘗試並產生錯誤前建立連接的等待時間 (以秒為單位)。 |
Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
Database |
當在衍生類別中被覆寫時,取得連線開啟後的目前資料庫名稱,或連線開啟前連接字串中所指定的資料庫名稱。 |
DataSource |
在衍生類別中被覆寫時,取得要連線之資料庫伺服器的名稱。 |
DbProviderFactory |
取得此 DbProviderFactory 的 DbConnection。 |
DesignMode |
取得值,指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
ServerVersion |
當在衍生類別中被覆寫時,取得代表物件所連線之伺服器版本的字串。 |
Site | (繼承來源 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() |
執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 |
Dispose() |
釋放 Component 所使用的所有資源。 (繼承來源 Component) |
Dispose(Boolean) |
釋放 DbConnection 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。 |
Dispose(Boolean) |
釋放 Component 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。 (繼承來源 Component) |
DisposeAsync() |
以非同步方式處置連線物件。 |
EnlistTransaction(Transaction) |
登記指定的交易。 |
Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
GetLifetimeService() |
已淘汰.
擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject) |
GetSchema() |
傳回這個 DbConnection 之資料來源的結構描述資訊。 |
GetSchema(String) |
使用結構描述名稱的特定字串,傳回這個 DbConnection 之資料來源的結構描述資訊。 |
GetSchema(String, String[]) |
使用結構描述名稱的特定字串和限制值的特定字串陣列,傳回這個 DbConnection 的資料來源的結構描述資訊。 |
GetSchemaAsync(CancellationToken) |
這是 GetSchema() 的非同步版本。
提供者應該覆寫為適當的實作。
您可以選擇性地接受 |
GetSchemaAsync(String, CancellationToken) |
這是 GetSchema(String) 的非同步版本。
提供者應該覆寫為適當的實作。
您可以選擇性地接受 |
GetSchemaAsync(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 所指定的設定開啟資料庫連接。 這個方法會叫用虛擬方法 OpenAsync(CancellationToken) 與 CancellationToken.None。 |
OpenAsync(CancellationToken) |
這是 Open() 的非同步版本。 提供者應該覆寫為適當的實作。 可以選擇性地接受取消語彙基元。 預設實作會叫用同步Open()呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken,預設實作會傳回已取消的工作。 Open 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 在傳回的工作完成之前,不叫用 |
ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
ToString() |
傳回任何包含 Component 名稱的 String。 不應覆寫此方法。 (繼承來源 Component) |
事件
Disposed |
當 Dispose() 方法的呼叫處置元件時,就會發生。 (繼承來源 Component) |
StateChange |
當連線的狀態變更時發生。 |
明確介面實作
IDbConnection.BeginTransaction() |
開始資料庫異動。 |
IDbConnection.BeginTransaction(IsolationLevel) |
使用指定的隔離等級開始資料庫異動。 |
IDbConnection.CreateCommand() |
建立並傳回與目前連線相關聯的 DbCommand 物件。 |
擴充方法
ConfigureAwait(IAsyncDisposable, Boolean) |
設定如何執行從非同步可處置項目傳回的工作 await。 |
適用於
另請參閱
- DbProviderFactory (ADO.NET)
- ADO.NET 概觀 \(部分機器翻譯\)
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應