Table of Contents

Class UnmatchedUpdateRecordsException

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

Exception thrown when unmatched UpdateBefore/UpdateAfter record pairs are detected during CDC (Change Data Capture) processing.

public sealed class UnmatchedUpdateRecordsException : ApiException, ISerializable
Inheritance
UnmatchedUpdateRecordsException
Implements
Inherited Members

Remarks

This exception indicates that during the processing of a specific LSN (Log Sequence Number), there were UpdateBefore records without corresponding UpdateAfter records, or vice versa, which violates the expected CDC data integrity constraints.

Constructors

UnmatchedUpdateRecordsException()

Initializes a new instance of the UnmatchedUpdateRecordsException class with default values.

public UnmatchedUpdateRecordsException()

UnmatchedUpdateRecordsException(byte[], int?, string?, Exception?)

Initializes a new instance of the UnmatchedUpdateRecordsException class.

public UnmatchedUpdateRecordsException(byte[] lsn, int? statusCode = null, string? message = null, Exception? innerException = null)

Parameters

lsn byte[]

The lsn with unmatched update records.

statusCode int?

The HTTP status code associated with the exception. Defaults to 500 if not specified.

message string

The custom error message. Defaults to a message indicating that no handler is found for the specified table.

innerException Exception

The inner exception that caused the current exception, if applicable.

Exceptions

ArgumentNullException

Thrown if lsn is null.

UnmatchedUpdateRecordsException(int, string?, Exception?)

Initializes a new instance of the UnmatchedUpdateRecordsException class with a status code, message, and inner exception.

public UnmatchedUpdateRecordsException(int statusCode, string? message, Exception? innerException)

Parameters

statusCode int

The HTTP status code associated with the exception.

message string

The error message that explains the reason for the exception.

innerException Exception

The exception that is the cause of the current exception.

UnmatchedUpdateRecordsException(string)

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

public UnmatchedUpdateRecordsException(string message)

Parameters

message string

The error message that explains the reason for the exception.

UnmatchedUpdateRecordsException(string, Exception?)

Initializes a new instance of the UnmatchedUpdateRecordsException class with a specified error message and inner exception.

public UnmatchedUpdateRecordsException(string message, Exception? innerException)

Parameters

message string

The error message that explains the reason for the exception.

innerException Exception

The exception that is the cause of the current exception.

Properties

Lsn

Gets or sets the LSN for which the duplicate record exists.

public byte[] Lsn { get; }

Property Value

byte[]

The LSN for which the duplicate record exists.