NReco LambdaParser

字符串表达式（公式、方法调用、属性/字段/数组访问器）的运行时解析器。LambdaParser构建动态LINQ表达式树并将其编译为lambda委托。类型在运行时解析，类似于动态语言。

NuGet	Windows x64	Linux

• 可用于任何 .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 IComparer
  • Sql：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许可证分发