LogRecordSequence.RetryAppend Property

Definition

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Gets or sets a value indicating whether or not appends are automatically retried if the log is full.

public:
 property bool RetryAppend { bool get(); void set(bool value); };

public bool RetryAppend { get; set; }

member this.RetryAppend : bool with get, set

Public Property RetryAppend As Boolean

Property Value

Boolean

true if appends are automatically retried if the log is full; otherwise, false. The default is true.

Implements

RetryAppend

Exceptions

ObjectDisposedException

The property was accessed after the sequence has been disposed of.

Examples

This example shows how to use the RetryAppend property.

// SET RETRY APPEND

// IO.Log provides a mechanism similar to AutoGrow.
// If the existing log is full and an append fails, setting RetryAppend
// invokes the CLFS policy engine to add new extents and re-tries
// record appends. If MaximumExtent count has been reached,
// a SequenceFullException is thrown.
//

sequence.RetryAppend = true;

// RETRY APPEND END

' SET RETRY APPEND

' IO.Log provides a mechanism similar to AutoGrow.
' If the existing log is full and an append fails, setting RetryAppend
' invokes the CLFS policy engine to add new extents and re-tries
' record appends. If MaximumExtent count has been reached, 
' a SequenceFullException is thrown. 
' 

sequence.RetryAppend = True

' RETRY APPEND END

Remarks

If the value of this property is true, and an Append call fails because there is not enough space in the sequence, the record sequence will try to free space and retry the append.