Class OutputRoutingException

Namespace

ItTiger.TigerQuery

Assembly

ItTiger.TigerQuery.dll

Represents a failure to route, serialize, or write script output.

[Serializable]
public sealed class OutputRoutingException : TigerQueryException, ISerializable

Inheritance

object

Exception

TigerQueryException

OutputRoutingException

Implements

ISerializable

Inherited Members

TigerQueryException.Line

TigerQueryException.Column

Exception.GetBaseException()

Exception.GetType()

Exception.ToString()

Exception.Data

Exception.HelpLink

Exception.HResult

Exception.InnerException

Exception.Message

Exception.Source

Exception.StackTrace

Exception.TargetSite

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.ReferenceEquals(object, object)

Remarks

This covers path resolution failures, channel collisions, directory-not-found, access denied, sharing violations, unencodable characters, CSV schema incompatibility, and flush or close failures. It never carries SQL Server diagnostics, connection strings, or SQL values.

An output failure is fatal regardless of the effective :ON ERROR policy and of ContinueOnErrorForUnhandledExceptions. When it occurs during a batch it becomes the primary exception of that batch and the run's Exception with OutputFailed.

Constructors

OutputRoutingException()

Initializes an exception without a message or target path.

public OutputRoutingException()

OutputRoutingException(string)

Initializes an exception with a message.

public OutputRoutingException(string message)

Parameters

message string

The error message.

OutputRoutingException(string, Exception)

Initializes an exception with a message and underlying exception.

public OutputRoutingException(string message, Exception inner)

Parameters

message string

The error message.

inner Exception

The exception that caused this failure.

OutputRoutingException(string, string?)

Initializes an exception with a message and the target path.

public OutputRoutingException(string message, string? path)

Parameters

message string

The error message.

path string

The resolved output path involved in the failure.

OutputRoutingException(string, string?, Exception)

Initializes an exception with a message, the target path, and the cause.

public OutputRoutingException(string message, string? path, Exception inner)

Parameters

message string

The error message.

path string

The resolved output path involved in the failure.

inner Exception

The exception that caused this failure.

Fields

ContemporaneousExceptionDataKey

Names the Data entry that holds a SQL Server exception observed at the same time as the output failure.

public const string ContemporaneousExceptionDataKey = "TigerQuery.ContemporaneousException"

Field Value

string

Remarks

The output failure always remains the primary exception; a contemporaneous SqlException is attached under this key as secondary diagnostic context only.

Properties

Path

Gets the output path involved in the failure, or null when no single path applies.

public string? Path { get; }

Property Value

string

Remarks

The value is the fully resolved path when resolution succeeded; otherwise it is the path exactly as the script or host supplied it.