Richard.Ma 发表于 2020-6-1 09:11:52

CalcEngine功能介绍

本帖最后由 Richard.Ma 于 2020-6-1 09:18 编辑

ComponentOne中的 CalcEngine是一个.NET标准库,可以在任何平台运行时分析和表达的评估上使用。该库可用于:
[*]解析和评估公式(例如Microsoft Excel)。
[*]计算销售预测或统计计算以找到数据模式。
[*]将数据从内存中的业务对象加载到DataGrid或显示计算值。
[*]使用变量评估代数表达式,数学函数和公式。
CalcEngine可用于ComponentOne中的所有.NET平台,并且该库作为nuget.org上的NuGet包提供。您也可以通过安装WinForms Edition获得示例代码。在本文中,我们将逐步介绍CalcEngine的主要功能,并展示它们如何工作。CalcEngine入门要开始使用CalcEngine,请创建一个.NET Framework 4.6.2+或.NET Core应用程序,然后将nuget.org中的C1.CalcEngine NuGet包添加到项目中。创建简单表达式如果您曾经使用过Excel,则使用CalcEngine创建和评估表达式非常简单明了。在这里,我们演示如何创建分配给CalcEngine的Expression属性的简单表达式,以及如何使用Evaluate函数获取结果。var calcEngine = new C1CalcEngine();
calcEngine.Expression = “5+2”;
var result = calcEngine.Evaluate()
CalcEngine还支持带有函数的更复杂的表达式。它支持Excel中的文本,日期时间,数学,逻辑,转换和聚合函数,以及各种常量和运算符。https://gccontent.blob.core.windows.net/gccontent/blogs/componentone/20200528-introducing-calcengine-for-dotnet/Formula.jpg有关支持功能的完整列表,请参阅文档。如果要将自定义函数添加到库中,可以使用AddFunction方法来实现。使用数据绑定跨数据源执行计算CalcEngine可以绑定到列表,数组或数据表等数据源。这有助于在对象和数据字段的集合上执行计算。在这里,我们有一个Store对象的集合,并使用CalcEngine将表达式应用于整个集合或单个对象。public class Store
{
    public int StoreId { get; set; }
    public double Sales { get; set; }
}

var collection = new List<Store>() { new Store { StoreId = 27, Sales = 150000.00 }, new Store { StoreId = 15, Sales = 20000.00 } };

// 1\. When you have to apply expression over an object:
var engine = new C1CalcEngine ();
engine.DataSource = collection;
engine.Expression = "*2";// 2\. When you have collection and aggregate function:
var engine = new C1CalcEngine ();
engine.DataSource = collection;
engine.Expression = "Sum()";
var result = engine.Evaluate();// 3\. When you have collection and need evaluate one entry:
var engine = new C1CalcEngine();
engine.DataSource = collection;
engine.CurrentIndex = 1;
engine.Expression = " / Sum()";
var result = engine.Evaluate();


处理多个数据收集当信息分散到多个集合中时,很难一起处理这些数据。这是交叉引用会有所帮助的地方。在这种情况下,可以使用内置的Excel引擎的跨工作表引用。在交叉表引用中,单元格引用包括对另一个表中单元格的引用。与Excel一样,它可以用在公式中,在该公式中输入目标工作表的名称,然后在单元格引用或单元格范围引用之前输入一个惊叹号(!)。calcEngine.Expression = "=Sum(Sheet1!A3:B7) + Sum(Sheet2!A3:B7)";
为了能够创建上述表达式,每个数据源都应从实现GetValue()函数的IDataSheet派生: public class SheetTable : DataTable, IDataSheet
    {
      public string Name
      {
            get => TableName;
            set => TableName = value;
      }

      public object GetValue(int col, int row)
      {
            return Rows;
      }
    }

在这里,GetValue从特定的行或列返回一个值。出于本文的目的,我们演示了一个使用上面实现的SheetTable类的简单数据源://Method to generate data for C1CalcEngine
    private const string columnNames = "ABCDEF";

    var sheet1 = GetDataTable("Sheet1");
   var sheet2 = GetDataTable("Sheet2");

    public static SheetTable GetDataTable(string sheetName)
    {
      var table = new SheetTable();
      table.Name = sheetName;
      foreach (var col in columnNames)
            table.Columns.Add(col.ToString(), typeof(int));
      for (int i = 0; i < 100; i++)
            table.Rows.Add(new object[] { i * 2, i * 3, i * 4, i * 5, i * 6, i * 7 });
      return table;
    }

最后,可以如下创建跨表表达式: C1CalcEngine calcEngine = new C1CalcEngine();

calcEngine.DataSource = new List<IDataSheet> { sheet1, sheet2 };

            //Assign the cross sheet reference expression to be calculated by C1CalcEngine
            calcEngine.Expression = "=Sum(Sheet1!A3:B7) + Sum(Sheet2!A3:B7)";

            //Invoke the TryEvaluate method of C1CalcEngine to calculate the expression
            var res = calcEngine.TryEvaluate(out object result) ? result.ToString() : calcEngine.GetErrors().FirstOrDefault()?.FullMessage ?? "";
下图显示了交叉表引用的示例,其中从单元格引用中解析了表达式。ComponentOne WinForms Edition中提供了此示例:https://gccontent.blob.core.windows.net/gccontent/blogs/componentone/20200528-introducing-calcengine-for-dotnet/ExcelEngine.gifComponentOne CalcEngine是一个功能强大的库,可以解决许多业务用例。欢迎使用,有任何问题欢迎回帖讨论


页: [1]
查看完整版本: CalcEngine功能介绍