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中的文本，日期时间，数学，逻辑，转换和聚合函数，以及各种常量和运算符。

有关支持功能的完整列表，请参阅文档。如果要将自定义函数添加到库中，可以使用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[0];

engine.Expression = "[Sales]*2";
复制代码
// 2\. When you have collection and aggregate function:

var engine = new C1CalcEngine ();

engine.DataSource = collection;

engine.Expression = "Sum([Sales])";

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 = "[Sales] / Sum([Sales])";

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[row][col];
}
}

复制代码

在这里，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中提供了此示例：

ComponentOne CalcEngine是一个功能强大的库，可以解决许多业务用例。欢迎使用，有任何问题欢迎回帖讨论

		自动登录	找回密码
密码			立即注册

CalcEngine功能介绍

0 个回复

SpreadJS 认证

SpreadJS 高级认证

讲师达人

悬赏达人