IRecordSequence.AdvanceBaseSequenceNumber(SequenceNumber) Method

Reference

Definition

Namespace:: System.IO.Log

Assembly:: System.IO.Log.dll

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.

Moves the base sequence number of the log forward.

public:
 void AdvanceBaseSequenceNumber(System::IO::Log::SequenceNumber newBaseSequenceNumber);

public void AdvanceBaseSequenceNumber (System.IO.Log.SequenceNumber newBaseSequenceNumber);

abstract member AdvanceBaseSequenceNumber : System.IO.Log.SequenceNumber -> unit

Public Sub AdvanceBaseSequenceNumber (newBaseSequenceNumber As SequenceNumber)

Parameters

newBaseSequenceNumber: SequenceNumber

The new base sequence number of the record sequence.

Exceptions

ArgumentException

newBaseSequenceNumber is invalid.

ArgumentOutOfRangeException

newBaseSequenceNumber is not active in the log.

IOException

An I/O error occurred while modifying the sequence.

ObjectDisposedException

The method was called after the sequence has been disposed of.

SequenceFullException

The record sequence is full.

Remarks

When you use a LogRecordSequence instance and try to advance the sequence number to free up space in the log, the new base sequence number must reside in a different log extent for the previous extent to be marked as empty. Freeing extents partially is not supported.

Applies to