語言

RelationalTransaction 類別

定義

針對資料庫的交易。

public class RelationalTransaction : IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<System.Data.Common.DbTransaction>, Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction
[System.Runtime.CompilerServices.Nullable(0)]
public class RelationalTransaction : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<System.Data.Common.DbTransaction>, Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction
public class RelationalTransaction : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<System.Data.Common.DbTransaction>, Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction
type RelationalTransaction = class
    interface IDbContextTransaction
    interface IDisposable
    interface IInfrastructure<DbTransaction>
[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalTransaction = class
    interface IDbContextTransaction
    interface IDisposable
    interface IAsyncDisposable
    interface IInfrastructure<DbTransaction>
type RelationalTransaction = class
    interface IDbContextTransaction
    interface IDisposable
    interface IAsyncDisposable
    interface IInfrastructure<DbTransaction>
Public Class RelationalTransaction
Implements IDbContextTransaction, IDisposable, IInfrastructure(Of DbTransaction)
Public Class RelationalTransaction
Implements IAsyncDisposable, IDbContextTransaction, IDisposable, IInfrastructure(Of DbTransaction)
繼承
RelationalTransaction
屬性
實作

備註

這個類別的實例通常是從 BeginTransaction() 應用程式中取得,且並非設計成直接在應用程式程式碼中建構。

更多資訊與範例請參閱 EF Core 中的交易 。

建構函式

名稱 Description
RelationalTransaction(IRelationalConnection, DbTransaction, Guid, IDiagnosticsLogger<DbLoggerCategory.Database.Transaction>, Boolean, ISqlGenerationHelper)

初始化 RelationalTransaction 類別的新執行個體。

RelationalTransaction(IRelationalConnection, DbTransaction, Guid, IDiagnosticsLogger<DbLoggerCategory.Database.Transaction>, Boolean)

初始化 RelationalTransaction 類別的新執行個體。

RelationalTransaction(IRelationalConnection, DbTransaction, IDiagnosticsLogger<DbLoggerCategory.Database.Transaction>, Boolean)

初始化 RelationalTransaction 類別的新執行個體。

RelationalTransaction(IRelationalConnection, DbTransaction, ILogger, Boolean)

初始化 RelationalTransaction 類別的新執行個體。

屬性

名稱 Description
Connection

那種連結。

Logger

伐木工。

SupportsSavepoints

會得到一個值,表示該 IDbContextTransaction 實例是否支援資料庫儲存點。 若 false,方法 CreateSavepointAsync(String, CancellationToken)與 RollbackToSavepointAsync(String, CancellationToken)ReleaseSavepointAsync(String, CancellationToken) 其同步對應方法預期會拋出 NotSupportedException。

TransactionId

一個關聯 ID,允許在多個資料庫呼叫中識別並關聯此交易。

方法

名稱 Description
ClearTransaction()

將底層交易從連線中移除

ClearTransactionAsync(CancellationToken)

將底層交易從連線中移除

Commit()

將目前交易中對資料庫的所有變更提交。

CommitAsync(CancellationToken)

非同步提交目前交易中資料庫的所有變更。

CreateSavepoint(String)

在交易中建立儲存點。 這可讓建立儲存點之後執行的所有命令復原,並將交易狀態還原至儲存點時的狀態。

CreateSavepointAsync(String, CancellationToken)

在交易中建立儲存點。 這可讓建立儲存點之後執行的所有命令復原,並將交易狀態還原至儲存點時的狀態。

Dispose()

執行與釋出、釋放或重設非受控資源相關聯的應用程式定義工作。

DisposeAsync()

執行與釋出、釋放或重設非受控資源相關聯的應用程式定義工作。

GetCreateSavepointSql(String)

當在支援交易儲存點的提供者中實作時,此方法應回傳一個 SQL 陳述式,建立帶有該名稱的儲存點。

GetReleaseSavepointSql(String)

當在支援交易儲存點的提供者中實作時,此方法應回傳一個 SQL 語句,釋放帶有該名稱的儲存點。

如果不支援儲存點釋放, ReleaseSavepoint(String)ReleaseSavepointAsync(String, CancellationToken) 應該被覆寫成什麼都不做。

GetRollbackToSavepointSql(String)

當在支援交易儲存點的提供者中實作時,此方法應回傳一個 SQL 陳述式,回滾帶有該名稱的儲存點。

ReleaseSavepoint(String)

終結先前在目前交易中定義的儲存點。 這可讓系統在交易結束時回收一些資源。

ReleaseSavepointAsync(String, CancellationToken)

終結先前在目前交易中定義的儲存點。 這可讓系統在交易結束時回收一些資源。

Rollback()

丟棄目前交易中資料庫的所有變更。

RollbackAsync(CancellationToken)

非同步丟棄目前交易中對資料庫所做的所有變更。

RollbackToSavepoint(String)

復原建立指定儲存點之後執行的所有命令。

RollbackToSavepointAsync(String, CancellationToken)

復原建立指定儲存點之後執行的所有命令。

明確介面實作

名稱 Description
IInfrastructure<DbTransaction>.Instance

針對資料庫的交易。

擴充方法

名稱 Description
GetDbTransaction(IDbContextTransaction)

取得該交易的標的 DbTransaction 資產。 若目標資料庫不是使用 DbTransaction的關聯式資料庫,則會拋出 。

GetInfrastructure<T>(IInfrastructure<T>)

從一個被隱藏的屬性中取得價值 IInfrastructure<T>。

此方法通常由資料庫提供者(及其他擴充)使用。 它通常不被用於應用程式程式碼中。

適用於