IDbContextTransaction.ReleaseSavepointAsync(String, CancellationToken) Method

Reference

Definition

Namespace:: Microsoft.EntityFrameworkCore.Storage

Assembly:: Microsoft.EntityFrameworkCore.dll

Package:: Microsoft.EntityFrameworkCore v5.0.0

Package:: Microsoft.EntityFrameworkCore v6.0.0

Package:: Microsoft.EntityFrameworkCore v7.0.0

Package:: Microsoft.EntityFrameworkCore v8.0.0

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Destroys a savepoint previously defined in the current transaction. This allows the system to reclaim some resources before the transaction ends.

public virtual System.Threading.Tasks.Task ReleaseSavepointAsync (string name, System.Threading.CancellationToken cancellationToken = default);

abstract member ReleaseSavepointAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ReleaseSavepointAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function ReleaseSavepointAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameters

name: String

The name of the savepoint to release.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for the task to complete.

Returns

Task

A Task representing the asynchronous operation.

Exceptions

OperationCanceledException

If the CancellationToken is canceled.

Remarks

If savepoint release isn't supported, ReleaseSavepoint(String) and ReleaseSavepointAsync(String, CancellationToken) should do nothing rather than throw. This is the default behavior.

See Transactions in EF Core for more information and examples.

Applies to