Class ReportExpressionException

Namespace

DocWright.Reporting.Expressions

Assembly

DocWright.Reporting.dll

A report expression could not be parsed, was refused, or failed while it was evaluated.

public sealed class ReportExpressionException : DocWrightException, ISerializable

Inheritance

object

Exception

DocWrightException

ReportExpressionException

Implements

ISerializable

Inherited Members

Exception.GetBaseException()

Exception.ToString()

Exception.GetType()

Exception.TargetSite

Exception.Message

Exception.Data

Exception.InnerException

Exception.HelpLink

Exception.Source

Exception.HResult

Exception.StackTrace

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

What a caller does with one is decided by DiagnosticCode, not by the exception type. The reference implementation refuses the whole report for DXP9101 (the expression does not compile), and shows #Error in place of the value for DXP9105 (it failed at run time); a report processor is expected to make the same distinction.

Resource limits are not reported this way. An expression that exceeds a budget raises ResourceLimitExceededException, because a limit is a property of the host's safety policy, not a defect in one textbox.

Constructors

ReportExpressionException()

Initializes an exception with no details.

ReportExpressionException(string)

Initializes an exception with a message.

ReportExpressionException(string, Exception?)

Initializes an exception with a message and an inner exception.

ReportExpressionException(string, string?, string?, int)

Initializes an exception with every detail.

Properties

DiagnosticCode

Gets the diagnostic code, one of the DXP91xx expression codes.

Expression

Gets the expression text, including its leading '=', when it is known.

Position

Gets the zero-based offset into Expression the failure refers to, or -1 when it refers to the expression as a whole — which is always the case for a run-time failure.