Method BeginStagedTransactionAsync

BeginStagedTransactionAsync()

Begins a new staged transaction for the file repository: a transaction that records all of its deletions in a single journal file, for application transactions that delete many files. It is committed in two calls, StageAsync(CancellationToken) before the application commits its database and CommitAsync(CancellationToken) after.

Declaration

public ValueTask<FileRepoStagedTransaction> BeginStagedTransactionAsync()

Returns

Type	Description
ValueTask<FileRepoStagedTransaction>

Remarks

See FileRepoStagedTransaction for when to use a staged transaction instead of one started with BeginTransactionAsync(), and for how it records its deletions on a version 1 repository, which has no journals.

Exceptions

Type	Condition
InvalidOperationException	The repository was opened read-only.