ReplayRestoreException

Replay execution failed unrecoverably during RestoreFromJson(string, RecoveryMode, ResolutionPolicy). The attached Diagnostics carry the partial restore state — how many commits were applied, which commit failed, and any ReplayWarning items collected before the failure.

public class ReplayRestoreException : Exception

Inheritance System.Object → System.Exception → ReplayRestoreException

Remarks

Only thrown under Transactional when a commit cannot be applied and the policy permits no further progress. Under the default BestEffort mode the runtime records the failure in ReplayDiagnostics and returns to the caller rather than throwing.

Catch ReplaySaveFormatException first: that exception is thrown when the JSON is unparseable, before replay begins. ReplayRestoreException is only thrown once a structurally valid ReplaySave is in hand and execution fails mid-replay.

Constructors

ReplayRestoreException(string, ReplayDiagnostics)

Initializes a new instance with a failure message and the partial ReplayDiagnostics captured at the time of failure.

public ReplayRestoreException(string message, ReplayDiagnostics diagnostics);

Parameters

message System.String

Human-readable description of what went wrong during replay.

diagnostics ReplayDiagnostics

Diagnostic snapshot including commit progress and any ReplayWarning items collected before the failure.

Properties

Diagnostics

Partial restore state at the point of failure — inspect CommitsApplied, FailureCommitIndex, and Warnings to understand how far replay progressed before the error occurred.

public ReplayDiagnostics Diagnostics { get; }

Property Value

ReplayDiagnostics

Inherited Methods

Inherited Properties

Inherited Events