动态表达式解析器(DynamicExpresso)完整指南：如何在.NET中实现运行时C表达式执行

动态表达式解析器(DynamicExpresso)完整指南：如何在.NET中实现运行时C#表达式执行

【免费下载链接】DynamicExpressoC# expressions interpreter项目地址: https://gitcode.com/gh_mirrors/dy/DynamicExpresso

你是否曾经需要在运行时动态执行C#表达式？DynamicExpresso正是为此而生！这个轻量级的C#表达式解释器让你能够在运行时编译和执行基于C#语法的字符串表达式，为构建动态计算、条件判断和脚本化应用程序提供了强大支持。本文将带你从入门到精通，全面掌握DynamicExpresso的核心功能和实战技巧。

🚀 快速上手：5分钟掌握基础用法

DynamicExpresso的核心是Interpreter类，它提供了一系列简单易用的方法来解析和执行表达式。让我们从一个最简单的例子开始：

using DynamicExpresso; // 创建解释器实例 var interpreter = new Interpreter(); // 执行简单数学表达式 int result = interpreter.Eval<int>("5 + 3 * 2"); Console.WriteLine($"结果是: {result}"); // 输出: 结果是: 11

就是这么简单！无需编译，无需复杂的配置，DynamicExpresso直接帮你计算表达式的值。

变量和参数的使用

在实际应用中，我们经常需要处理带变量的表达式：

var interpreter = new Interpreter() .SetVariable("price", 99.99m) .SetVariable("quantity", 3); decimal total = interpreter.Eval<decimal>("price * quantity * 0.9"); Console.WriteLine($"总价（含9折优惠）: {total}");

上图展示了DynamicExpresso处理表达式的完整工作流程：从文本表达式和变量输入，经过Lambda表达式转换，最终生成可执行的委托。

🔧 核心特性详解

1. 类型安全的表达式解析

DynamicExpresso支持强类型解析，确保编译时类型安全：

var target = new Interpreter(); double result = target.Eval<double>("Math.Pow(x, y) + 5", new Parameter("x", typeof(double), 10), new Parameter("y", typeof(double), 2)); Console.WriteLine($"10的2次方加5: {result}"); // 输出: 105

2. 动态委托生成

这是DynamicExpresso最强大的功能之一，你可以将字符串表达式转换为强类型委托：

// 生成Func<int, bool>委托用于LINQ查询 var prices = new[] { 5, 8, 6, 2 }; var interpreter = new Interpreter(); Func<int, bool> filterFunc = interpreter.ParseAsDelegate<Func<int, bool>>("arg > 5"); var filtered = prices.Where(filterFunc).ToList(); Console.WriteLine($"大于5的价格数量: {filtered.Count}"); // 输出: 2

3. Lambda表达式支持

启用Lambda表达式功能，你可以在表达式中使用LINQ等高级功能：

var words = new string[] { "this", "is", "awesome" }; var options = InterpreterOptions.Default | InterpreterOptions.LambdaExpressions; var interpreter = new Interpreter(options) .SetVariable("words", words); var results = interpreter.Eval<IEnumerable<string>>( "words.Where(str => str.Length > 5).Select(str => str.ToUpper())"); foreach (var word in results) { Console.WriteLine(word); // 输出: AWESOME }

4. 自定义函数和扩展方法

你可以注册自定义函数，甚至使用扩展方法：

// 注册自定义函数 Func<double, double, double> power = (x, y) => Math.Pow(x, y); var interpreter = new Interpreter().SetFunction("pow", power); Console.WriteLine($"3的平方: {interpreter.Eval("pow(3, 2)")}"); // 使用扩展方法 var numbers = new int[] { 10, 30, 4 }; var target = new Interpreter() .Reference(typeof(System.Linq.Enumerable)) .SetVariable("numbers", numbers); Console.WriteLine($"数组长度: {target.Eval("numbers.Count()")}");

💡 实战演练：构建动态查询系统

让我们通过一个实际案例来展示DynamicExpresso的强大功能。假设我们需要构建一个动态产品筛选系统：

public class Product { public string Name { get; set; } public decimal Price { get; set; } public int Stock { get; set; } public string Category { get; set; } } public class DynamicProductFilter { private readonly Interpreter _interpreter; public DynamicProductFilter() { _interpreter = new Interpreter() .Reference(typeof(System.Linq.Enumerable)); } public IEnumerable<Product> FilterProducts( List<Product> products, string filterExpression) { // 解析过滤条件 Func<Product, bool> filter = _interpreter .ParseAsDelegate<Func<Product, bool>>(filterExpression, "product"); return products.Where(filter); } } // 使用示例 var products = new List<Product> { new Product { Name = "Laptop", Price = 1200, Stock = 10, Category = "Electronics" }, new Product { Name = "Mouse", Price = 25, Stock = 50, Category = "Electronics" }, new Product { Name = "Book", Price = 15, Stock = 100, Category = "Books" } }; var filter = new DynamicProductFilter(); var expensiveElectronics = filter.FilterProducts( products, "product.Price > 100 && product.Category == 'Electronics'");

这个系统允许用户通过字符串表达式动态定义过滤条件，非常适合构建配置化的查询界面。

🛡️ 安全最佳实践

当允许用户输入表达式时，安全是首要考虑因素。以下是几个重要的安全配置：

// 1. 禁用赋值操作符，防止用户修改变量 var safeInterpreter = new Interpreter() .EnableAssignment(AssignmentOperators.None); // 2. 控制反射权限（默认已禁用危险反射操作） // 如果需要反射功能，需要显式启用 var withReflection = new Interpreter().EnableReflection(); // 3. 限制可访问的类型 var restrictedInterpreter = new Interpreter() .Reference(typeof(Math)) // 只允许访问Math类 .Reference(typeof(DateTime)); // 只允许访问DateTime类 // 4. 使用参数而非变量传递用户数据 var interpreter = new Interpreter(); var userInput = "price * quantity"; var parameters = new[] { new Parameter("price", 99.99m), new Parameter("quantity", 2) }; var result = interpreter.Eval<decimal>(userInput, parameters);

🚀 性能优化技巧

1. 预编译表达式

对于需要多次执行的表达式，预编译可以显著提升性能：

var interpreter = new Interpreter(); var expression = "x * y + z"; // 预编译表达式 var parameters = new[] { new Parameter("x", typeof(decimal)), new Parameter("y", typeof(decimal)), new Parameter("z", typeof(decimal)) }; var compiledExpression = interpreter.Parse(expression, parameters); // 多次高效执行 for (int i = 0; i < 1000; i++) { var result = compiledExpression.Invoke(10m, 20m, 30m); // 处理结果... }

2. 线程安全使用

Interpreter类的解析和求值方法是线程安全的，但配置方法需要在初始化阶段完成：

// 初始化阶段（单线程） var interpreter = new Interpreter() .SetVariable("taxRate", 0.1m) .Reference(typeof(Math)) .EnableAssignment(AssignmentOperators.None); // 使用阶段（多线程安全） Parallel.For(0, 100, i => { var result = interpreter.Eval<decimal>($"price * {i} * (1 + taxRate)"); // 线程安全地使用结果 });

🔍 高级特性探索

1. 标识符检测

在解析表达式之前检测使用的标识符：

var interpreter = new Interpreter(); var detected = interpreter.DetectIdentifiers("x + y * taxRate"); Console.WriteLine($"未知标识符: {string.Join(", ", detected.UnknownIdentifiers)}"); Console.WriteLine($"已知标识符: {string.Join(", ", detected.Identifiers.Select(i => i.Name))}");

2. 默认数值类型配置

在财务计算等场景中，你可能希望默认使用decimal类型：

var financialInterpreter = new Interpreter(); financialInterpreter.SetDefaultNumberType(DefaultNumberType.Decimal); var result = financialInterpreter.Eval("10 / 3"); Console.WriteLine($"财务计算: {result} (类型: {result.GetType().Name})");

3. 特殊标识符支持

this标识符的特殊处理：

class Customer { public string Name { get; set; } } var interpreter = new Interpreter(); interpreter.SetVariable("this", new Customer { Name = "John" }); // 显式引用 Console.WriteLine(interpreter.Eval("this.Name")); // 输出: John // 隐式引用 Console.WriteLine(interpreter.Eval("Name")); // 输出: John

📁 项目结构概览

了解项目结构有助于更好地使用DynamicExpresso：

• 核心源码：src/DynamicExpresso.Core/ - 包含所有核心类和接口
• 单元测试：test/DynamicExpresso.UnitTest/ - 完整的测试套件
• 示例项目：sample/DynamicExpressoWebShell/ - Web交互式演示
• 官方文档：docs/ - 包含工作流程图等文档资源

🎯 常见应用场景

DynamicExpresso在以下场景中表现出色：

1. 动态配置规则：允许用户通过配置文件定义业务规则
2. 报表计算引擎：动态计算公式，无需重新编译
3. 数据验证系统：根据条件动态验证数据
4. 动态查询构建器：构建灵活的LINQ查询
5. 教学工具：C#表达式学习和测试平台

📝 开始使用

要开始使用DynamicExpresso，只需通过NuGet安装：

dotnet add package DynamicExpresso.Core

或者在你的项目文件中添加：

<PackageReference Include="DynamicExpresso.Core" Version="2.16.1" />

🌟 总结

DynamicExpresso为.NET开发者提供了一个强大而灵活的动态表达式执行解决方案。无论是构建脚本化应用程序、实现动态查询，还是创建可配置的业务规则引擎，它都能胜任。通过本文的指南，你已经掌握了从基础使用到高级特性的全面知识。

现在，是时候在你的项目中尝试DynamicExpresso了！从简单的数学表达式开始，逐步探索其强大的动态功能。如果你在使用过程中遇到问题或有改进建议，欢迎参与项目的开发和讨论。

记住，最好的学习方式就是实践。动手编写一些表达式，尝试不同的配置选项，你会发现DynamicExpresso为你的.NET项目带来的无限可能性！🚀

【免费下载链接】DynamicExpressoC# expressions interpreter项目地址: https://gitcode.com/gh_mirrors/dy/DynamicExpresso