Table of Contents

Class SqlServerCdcStalePositionException

Namespace
Excalibur.Cdc.SqlServer
Assembly
Excalibur.Cdc.SqlServer.dll

Exception thrown when the SQL Server CDC processor encounters a stale LSN position that cannot be recovered.

public sealed class SqlServerCdcStalePositionException : CdcStalePositionException, ISerializable
Inheritance
SqlServerCdcStalePositionException
Implements
Inherited Members

Remarks

This exception is thrown when:

  • Throw is configured
  • Recovery attempts are exhausted for any strategy
  • The callback handler throws an exception during InvokeCallback

The exception contains detailed information about the stale position scenario via EventArgs. Inherits from CdcStalePositionException so consumers can catch all CDC stale position errors generically.

Constructors

SqlServerCdcStalePositionException()

Initializes a new instance of the SqlServerCdcStalePositionException class.

public SqlServerCdcStalePositionException()

SqlServerCdcStalePositionException(CdcPositionResetEventArgs, string?, Exception?)

Initializes a new instance of the SqlServerCdcStalePositionException class with stale position event details.

public SqlServerCdcStalePositionException(CdcPositionResetEventArgs eventArgs, string? message = null, Exception? innerException = null)

Parameters

eventArgs CdcPositionResetEventArgs

The event arguments containing details about the stale position scenario.

message string

The optional custom error message.

innerException Exception

The exception that is the cause of the current exception.

SqlServerCdcStalePositionException(string)

Initializes a new instance of the SqlServerCdcStalePositionException class with a specified error message.

public SqlServerCdcStalePositionException(string message)

Parameters

message string

The message that describes the error.

SqlServerCdcStalePositionException(string, Exception?)

Initializes a new instance of the SqlServerCdcStalePositionException class with a specified error message and a reference to the inner exception that is the cause of this exception.

public SqlServerCdcStalePositionException(string message, Exception? innerException)

Parameters

message string

The message that describes the error.

innerException Exception

The exception that is the cause of the current exception.

Properties

CaptureInstance

Gets the capture instance (table) affected by the stale position.

public string? CaptureInstance { get; }

Property Value

string

The capture instance name, or null if not available.