Class RelationalTransaction

Namespace

Microsoft.EntityFrameworkCore.Storage

Assembly

Microsoft.EntityFrameworkCore.Relational.dll

A transaction against the database.

public class RelationalTransaction : IDbContextTransaction, IDisposable, IAsyncDisposable, IInfrastructure<DbTransaction>

Inheritance

object

RelationalTransaction

Implements

IDbContextTransaction

IDisposable

IAsyncDisposable

IInfrastructure<DbTransaction>

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

Instances of this class are typically obtained from Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.BeginTransaction and it is not designed to be directly constructed in your application code.

See Transactions in EF Core for more information and examples.

Constructors

RelationalTransaction(IRelationalConnection, DbTransaction, Guid, IDiagnosticsLogger<Transaction>, bool, ISqlGenerationHelper)

Initializes a new instance of the RelationalTransaction class.

public RelationalTransaction(IRelationalConnection connection, DbTransaction transaction, Guid transactionId, IDiagnosticsLogger<DbLoggerCategory.Database.Transaction> logger, bool transactionOwned, ISqlGenerationHelper sqlGenerationHelper)

Parameters

connection IRelationalConnection

The connection to the database.

transaction DbTransaction

The underlying DbTransaction.

transactionId Guid

The correlation ID for the transaction.

logger IDiagnosticsLogger<Transaction>

The logger to write to.

transactionOwned bool

A value indicating whether the transaction is owned by this class (i.e. if it can be disposed when this class is disposed).

sqlGenerationHelper ISqlGenerationHelper

The SQL generation helper to use.

Properties

Connection

The connection.

protected virtual IRelationalConnection Connection { get; }

Property Value

IRelationalConnection

Logger

The logger.

protected virtual IDiagnosticsLogger<DbLoggerCategory.Database.Transaction> Logger { get; }

Property Value

IDiagnosticsLogger<Transaction>

SupportsSavepoints

public virtual bool SupportsSavepoints { get; }

Property Value

bool

TransactionId

public virtual Guid TransactionId { get; }

Property Value

Guid

Methods

ClearTransaction()

Remove the underlying transaction from the connection

protected virtual void ClearTransaction()

ClearTransactionAsync(CancellationToken)

Remove the underlying transaction from the connection

protected virtual Task ClearTransactionAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

Returns

Task

Commit()

public virtual void Commit()

CommitAsync(CancellationToken)

public virtual Task CommitAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

Returns

Task

CreateSavepoint(string)

public virtual void CreateSavepoint(string name)

Parameters

name string

CreateSavepointAsync(string, CancellationToken)

public virtual Task CreateSavepointAsync(string name, CancellationToken cancellationToken = default)

Parameters

name string

cancellationToken CancellationToken

Returns

Task

Dispose()

public virtual void Dispose()

DisposeAsync()

public virtual ValueTask DisposeAsync()

Returns

ValueTask

ReleaseSavepoint(string)

public virtual void ReleaseSavepoint(string name)

Parameters

name string

ReleaseSavepointAsync(string, CancellationToken)

public virtual Task ReleaseSavepointAsync(string name, CancellationToken cancellationToken = default)

Parameters

name string

cancellationToken CancellationToken

Returns

Task

Rollback()

public virtual void Rollback()

RollbackAsync(CancellationToken)

public virtual Task RollbackAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

Returns

Task

RollbackToSavepoint(string)

public virtual void RollbackToSavepoint(string name)

Parameters

name string

RollbackToSavepointAsync(string, CancellationToken)

public virtual Task RollbackToSavepointAsync(string name, CancellationToken cancellationToken = default)

Parameters

name string

cancellationToken CancellationToken

Returns

Task