RelationalConnection 類別

定義

命名空間:

Microsoft.EntityFrameworkCore.Storage

組件:

Microsoft.EntityFrameworkCore.Relational.dll

套件:

Microsoft.EntityFrameworkCore.Relational v10.0.0

來源:

RelationalConnection.cs

代表與關聯式資料庫的連線。

此類型通常由資料庫提供者（及其他擴充功能）使用。 它通常不被用於應用程式程式碼中。

[System.Runtime.CompilerServices.Nullable(0)]
public abstract class RelationalConnection : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Storage.IDbContextTransactionManager, Microsoft.EntityFrameworkCore.Storage.IRelationalConnection, Microsoft.EntityFrameworkCore.Storage.ITransactionEnlistmentManager

[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalConnection = class
    interface IRelationalConnection
    interface IRelationalTransactionManager
    interface IDbContextTransactionManager
    interface IResettableService
    interface IDisposable
    interface IAsyncDisposable
    interface ITransactionEnlistmentManager

Public MustInherit Class RelationalConnection
Implements IAsyncDisposable, IDbContextTransactionManager, IDisposable, IRelationalConnection, ITransactionEnlistmentManager

繼承

Object

RelationalConnection

屬性

NullableAttribute

實作

IDbContextTransactionManager IRelationalConnection IRelationalTransactionManager IDisposable IResettableService ITransactionEnlistmentManager IAsyncDisposable

備註

服役期間為 Scoped。 這表示每個 DbContext 實例都會使用自己的服務實例。 實作方式可能取決於其他註冊於任何生命週期的服務。 實作不需要執行緒安全。

更多資訊與範例請參見 資料庫提供者與擴充功能的實作 。

建構函式

名稱	Description
RelationalConnection(RelationalConnectionDependencies)	初始化 RelationalConnection 類別的新執行個體。

屬性

名稱	Description
CommandTimeout	執行資料庫指令時會獲得逾時。
ConnectionId	此連線的唯一識別碼。
ConnectionString	取得或設定資料庫的 連接字串。
Context	目前使用的是 DbContext 。
CurrentAmbientTransaction	目前的環境交易。 預設為 Current。
CurrentTransaction	取得目前的交易。
DbConnection	取得或設定用於連接資料庫的底層 DbConnection 資料。
Dependencies	此服務的關聯提供者專屬相依關係。
EnlistedTransaction	目前登記的交易。
SupportsAmbientTransactions	表示儲存連線是否支援環境交易

方法

名稱	Description
BeginTransaction()	開始一筆新交易。
BeginTransaction(IsolationLevel)	開始一筆新交易。
BeginTransactionAsync(CancellationToken)	非同步開始新交易。
BeginTransactionAsync(IsolationLevel, CancellationToken)	非同步開始新交易。
Close()	關閉了與資料庫的連線。
CloseAsync()	關閉了與資料庫的連線。
CloseDbConnection()	範本方法預設會呼叫 Close() ，但服務提供者可以覆蓋，讓它打出不同的通話。
CloseDbConnectionAsync()	範本方法預設會呼叫 CloseAsync() ，但服務提供者可以覆蓋，讓它打出不同的通話。
CommitTransaction()	將目前交易中對資料庫的所有變更提交。
CommitTransactionAsync(CancellationToken)	將目前交易中對資料庫的所有變更提交。
ConnectionBeginTransaction(IsolationLevel)	範本方法預設會呼叫 BeginDbTransaction(IsolationLevel) ，但服務提供者可以覆蓋，讓它打出不同的通話。
ConnectionBeginTransactionAsync(IsolationLevel, CancellationToken)	範本方法預設會呼叫 BeginDbTransactionAsync(IsolationLevel, CancellationToken) ，但服務提供者可以覆蓋，讓它打出不同的通話。
ConnectionEnlistTransaction(Transaction)	範本方法預設會呼叫 EnlistTransaction(Transaction) ，但服務提供者可以覆蓋，讓它打出不同的通話。
CreateDbConnection()	建立資料庫 DbConnection 。
Dispose()	執行與釋出、釋放或重設非受控資源相關聯的應用程式定義工作。
DisposeAsync()	執行與釋出、釋放或重設非受控資源相關聯的應用程式定義工作。
DisposeDbConnection()	範本方法預設會呼叫 Dispose() ，但服務提供者可以覆蓋，讓它打出不同的通話。
DisposeDbConnectionAsync()	範本方法預設會呼叫 DisposeAsync() ，但服務提供者可以覆蓋，讓它打出不同的通話。
EnlistTransaction(Transaction)	指定一個用於資料庫操作的現有 Transaction 工具。
GetValidatedConnectionString()	只有在已設定或存在有效DbConnection連接字串時，才回傳已設定的 連接字串。
Open(Boolean)	開啟與資料庫的連線。
OpenAsync(CancellationToken, Boolean)	非同步開啟與資料庫的連線。
OpenDbConnection(Boolean)	範本方法預設會呼叫 Open() ，但服務提供者可以覆蓋，讓它打出不同的通話。
OpenDbConnectionAsync(Boolean, CancellationToken)	範本方法預設會呼叫 OpenAsync() ，但服務提供者可以覆蓋，讓它打出不同的通話。
RentCommand()	租用一個關聯指令，可在此連線下執行。
ResetState(Boolean)	重置連線狀態。 由 and ResetState()稱為 Dispose() 。
ResetStateAsync(Boolean)	重置連線狀態。 由 and ResetStateAsync(CancellationToken)稱為 DisposeAsync() 。
ReturnCommand(IRelationalCommand)	回傳一個關聯式指令給此連線，以便未來可重複使用。
RollbackTransaction()	丟棄目前交易中資料庫的所有變更。
RollbackTransactionAsync(CancellationToken)	丟棄目前交易中資料庫的所有變更。
SetDbConnection(DbConnection, Boolean)	設定連接資料庫的底層 DbConnection 。
UseTransaction(DbTransaction, Guid)	指定一個用於資料庫操作的現有 DbTransaction 工具。
UseTransaction(DbTransaction)	指定一個用於資料庫操作的現有 DbTransaction 工具。
UseTransactionAsync(DbTransaction, CancellationToken)	指定一個用於資料庫操作的現有 DbTransaction 工具。
UseTransactionAsync(DbTransaction, Guid, CancellationToken)	指定一個用於資料庫操作的現有 DbTransaction 工具。

明確介面實作

名稱	Description
IResettableService.ResetState()	代表與關聯式資料庫的連線。 此類型通常由資料庫提供者（及其他擴充功能）使用。 它通常不被用於應用程式程式碼中。
IResettableService.ResetStateAsync(CancellationToken)	代表與關聯式資料庫的連線。 此類型通常由資料庫提供者（及其他擴充功能）使用。 它通常不被用於應用程式程式碼中。