Class Expression

Namespace

NCalc

Assembly

NCalc.Sync.dll

This class represents a mathematical or logical expression that can be evaluated. It supports caching, custom parameter and function evaluation, and options for handling null parameters and iterating over parameter collections. The class manages the parsing, validation, and evaluation of expressions, and provides mechanisms for error detection and reporting.

public class Expression : ExpressionBase<ExpressionContext>

Inheritance

object

ExpressionBase<ExpressionContext>

Expression

Inherited Members

ExpressionBase<ExpressionContext>.Context

ExpressionBase<ExpressionContext>.Options

ExpressionBase<ExpressionContext>.CultureInfo

ExpressionBase<ExpressionContext>.Parameters

ExpressionBase<ExpressionContext>.ExpressionString

ExpressionBase<ExpressionContext>.LogicalExpression

ExpressionBase<ExpressionContext>.Error

ExpressionBase<ExpressionContext>.GetParameterNames()

ExpressionBase<ExpressionContext>.GetFunctionNames()

ExpressionBase<ExpressionContext>.HasErrors()

ExpressionBase<ExpressionContext>.GetLogicalExpression()

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

LambdaCompilationExtensions.ToLambda<TResult>(Expression)

LambdaCompilationExtensions.ToLambda<TContext, TResult>(Expression)

LambdaCompilationExtensions.ToLinqExpression<TResult>(Expression)

LambdaCompilationExtensions.ToLinqExpression<TContext, TResult>(Expression)

Constructors

Expression(LogicalExpression)

public Expression(LogicalExpression logicalExpression)

Parameters

logicalExpression LogicalExpression

Expression(LogicalExpression, ExpressionContext?)

public Expression(LogicalExpression logicalExpression, ExpressionContext? context = null)

Parameters

logicalExpression LogicalExpression

context ExpressionContext

Expression(LogicalExpression, ExpressionContext, ILogicalExpressionFactory, ILogicalExpressionCache, IEvaluationVisitorFactory)

public Expression(LogicalExpression logicalExpression, ExpressionContext context, ILogicalExpressionFactory factory, ILogicalExpressionCache cache, IEvaluationVisitorFactory evaluationVisitorFactory)

Parameters

logicalExpression LogicalExpression

context ExpressionContext

factory ILogicalExpressionFactory

cache ILogicalExpressionCache

evaluationVisitorFactory IEvaluationVisitorFactory

Expression(LogicalExpression, ExpressionOptions, CultureInfo?)

public Expression(LogicalExpression logicalExpression, ExpressionOptions options = ExpressionOptions.None, CultureInfo? cultureInfo = null)

Parameters

logicalExpression LogicalExpression

options ExpressionOptions

cultureInfo CultureInfo

Expression(string?)

public Expression(string? expression)

Parameters

expression string

Expression(string?, ExpressionContext?)

public Expression(string? expression, ExpressionContext? context = null)

Parameters

expression string

context ExpressionContext

Expression(string, ExpressionContext, ILogicalExpressionFactory, ILogicalExpressionCache, IEvaluationVisitorFactory)

public Expression(string expression, ExpressionContext context, ILogicalExpressionFactory factory, ILogicalExpressionCache cache, IEvaluationVisitorFactory evaluationVisitorFactory)

Parameters

expression string

context ExpressionContext

factory ILogicalExpressionFactory

cache ILogicalExpressionCache

evaluationVisitorFactory IEvaluationVisitorFactory

Expression(string?, ExpressionOptions, CultureInfo?)

public Expression(string? expression, ExpressionOptions options = ExpressionOptions.None, CultureInfo? cultureInfo = null)

Parameters

expression string

options ExpressionOptions

cultureInfo CultureInfo

Properties

DynamicParameters

public IDictionary<string, ExpressionParameter> DynamicParameters { get; set; }

Property Value

IDictionary<string, ExpressionParameter>

EvaluationVisitorFactory

protected IEvaluationVisitorFactory EvaluationVisitorFactory { get; }

Property Value

IEvaluationVisitorFactory

Functions

public IDictionary<string, ExpressionFunction> Functions { get; set; }

Property Value

IDictionary<string, ExpressionFunction>

Methods

Evaluate()

Evaluates the logical expression.

public object? Evaluate()

Returns

object

The result of the evaluation.

Exceptions

NCalcException

Thrown when there is an error in the expression.

Events

EvaluateFunction

Event triggered to handle function evaluation.

public event EvaluateFunctionHandler EvaluateFunction

Event Type

EvaluateFunctionHandler

EvaluateParameter

Event triggered to handle parameter evaluation.

public event EvaluateParameterHandler EvaluateParameter

Event Type

EvaluateParameterHandler