可序列化公式 2.1.0

可序列化公式

可序列化公式是一个用于计算包含在方便的可序列化对象中的基于文本公式的快速库。添加您自己的自定义函数和变量。计算布尔值、字符串和浮点输出。

用法

初始化

首先创建一个简单的可序列化公式对象，设置所需的结果类型和公式文本。

	var newFormula = new SerializableFormula();
	newFormula.FormulaResultType = TResultType.Float;
	newformula.FormulaText = "Average(a, b, c, d, e)";

定义自定义变量

现在您必须定义函数的每个部分。上面的可序列化公式对象在不知道每个部分做什么之前无法处理每个函数。

定义您的变量

	var a = new FormulaVariable("a", 4);
	var b = new FormulaVariable("b", 2);
	var c = new FormulaVariable("c", 7);
	var d = new FormulaVariable("d", 10);
	var e = new FormulaVariable("e", 20);
	newFormula.AddVariable(a);
	newFormula.AddVariable(b);
	newFormula.AddVariable(c);
	newFormula.AddVariable(d);
	newFormula.AddVariable(e);

定义函数

定义 Average 函数

	var average = new TAverageFunction();
	newFormula.AddFunction(average);

Average 函数是随可序列化公式捆绑提供的自定义函数。稍后关于自定义函数的更多信息。

验证语法

使用 VerifySyntax() 函数返回一个包含以下内容的对象 SyntaxCheckResult：

• ExpressionError ：包含友好错误信息的字符串
• ExpressionErrorToken ：仅包含错误文本标记的字符串
• ExpressionErrorPosition ：表示公式字符串中错误发生位置的整数

计算

最后，我们可以通过调用匹配输出类型的函数来获取我们的结果

• var result = newFormula.CalculateText();
• var result = newFormula.CalculateLogical();
• var result = newFormula.CalculateArithmetic();

自定义函数

为了创建自定义函数，您只需创建一个新的对象来实现IFormulaFunction。一旦实现，您就可以使用AddFunction()方法将您的函数添加到可序列化公式中。

默认标识符

这些标识符始终是可序列化公式的组成部分。它们不能用于命名函数或变量。

布尔运算符

• 或
• 异或（xor）
• 与
• 真（true）
• 假（false）
• 非（not）
• 如果（if）
• 情况（case）

数学运算符

• +
• -
• <
• <=
• >
• >=
• <>
• =
• /
• *
• ^
• (
• )
• ,