NReco LambdaParser
字符串表达式(公式、方法调用、属性/字段/数组访问器)的运行时解析器。LambdaParser
构建动态LINQ表达式树并将其编译为lambda委托。类型在运行时解析,类似于动态语言。
- 可用于任何 .NET应用:net45(旧版.NET Framework应用)、netstandard1.3(.NET Core应用)、netstandard2.0(所有现代.NET应用)。
- 支持任意数量的表达式参数(值可以通过字典或回调委托提供)
- 支持算术运算(+, -, *, /, %)、比较运算(==, !=, >, <, >=, <=)、条件运算包括三元运算符(boolVal ? whenTrue : whenFalse)
- 访问对象属性、调用方法和索引器、调用委托
- 动态类型变量:自动执行类型转换以匹配方法签名或算术运算
- 使用简化语法创建数组和字典:
new dictionary{ {"a", 1}, {"b", 2} }
,new []{ 1, 2, 3}
- 支持局部变量,可以在主表达式之前声明:
var a = 5; var b = contextVar/total*100;
(默认禁用,使用LambdaParser.AllowVars
属性启用)
Nuget包:NReco.LambdaParser
var lambdaParser = new NReco.Linq.LambdaParser();
var varContext = new Dictionary<string,object>();
varContext["pi"] = 3.14M;
varContext["one"] = 1M;
varContext["two"] = 2M;
varContext["test"] = "test";
Console.WriteLine( lambdaParser.Eval("pi>one && 0<one ? (1+8)/3+1*two : 0", varContext) ); // --> 5
Console.WriteLine( lambdaParser.Eval("test.ToUpper()", varContext) ); // --> TEST
(更多表达式示例请参见单元测试)
自定义值比较
默认情况下,LambdaParser
使用ValueComparer
进行值比较。您可以提供自己的实现或配置其选项以获得所需的行为:
ValueComparer.NullComparison
决定如何处理与null
的比较。有两个选项:MinValue
:null被视为任何类型的最小可能值 - 类似于.NET IComparerSql
:null与任何类型都不可比较,包括另一个null - 类似于SQL
ValueComparer.SuppressErrors
允许避免转换异常。如果在比较过程中出现错误,不会抛出异常,这意味着值不可比较(任何条件都导致false
)。
var valComparer = new ValueComparer() { NullComparison = ValueComparer.NullComparisonMode.Sql };
var lambdaParser = new LambdaParser(valComparer);
缓存表达式
UseCache
属性决定LambdaParser
是否应缓存解析后的表达式。默认情况下,UseCache
设置为true
,这意味着表达式会被缓存以提高重复评估相同表达式的性能。
因此,建议使用LambdaParser
的单例实例,而不是每次都创建一个新实例。
如果您想节省内存,特别是在评估大量唯一表达式时,可以通过将UseCache设置为false来禁用缓存。
var lambdaParser = new LambdaParser();
lambdaParser.UseCache = false;
谁在使用这个?
NReco.LambdaParser在SeekTable.com和PivotData微服务中投入生产使用(用于用户定义的计算多维数据集成员:公式、自定义格式化)。
许可证
版权所有 2016-2024 Vitaliy Fedorchenko 和贡献者
基于MIT许可证分发