本文将介绍图表开发工具 Stimulsoft表达式中的关于使用字典变量、数据字段等相关内容。

Stimulsoft Ultimate官方正版下载

Stimulsoft Ultimate是用于创建报表和仪表板的通用工具集，支持多种报表导出格式，拥有简单且强大的报表引擎。

使用字典变量

可以在设计器数据字典中创建变量，然后可以在表达式中使用这些变量。当您在表达式中指定变量的名称时，该变量的值将包含在报告中。语法就是用大括号括起来的变量名。例如，如果您将变量的值设置为 5 并输入以下表达式：

Value = {MyVariable}

那么经过计算，报告中出现的结果将是：

Value = 5

用变量计算

变量也可以用于计算。例如，如果MyVariable的值为 15，并且您输入以下表达式：

{数据源.列}

那么经过计算，报告中出现的结果将是：

Value = 25

重要提示：如果报告语言为C# ，则变量名称区分大小写。如果报告语言是VB.Net ，则变量名不区分大小写。

使用数据字段

来自数据源的值可用于表达式。要从数据源引用字段，您必须提供该字段的字符串表示形式。引用的语法很简单——你给出数据源的名称和字段名称，用小数点或句号分隔，用大括号括起来：

ValueA = {1 + 2}, ValueB = {2 + 3}

例如，如果您在客户表中有一个条目，其中公司名称字段设置为“The Big Company”，并且您输入以下表达式：

公司名称：{Customers.CompanyName}

那么经过计算，报告中出现的结果将是：

公司名称：大公司

注意：为避免手动创建此类表达式，您可以使用从数据字典直接拖放到报表页面或在表达式编辑器中使用正确的语法自动插入必要的信息。

父母关系

如果数据源与其他数据源具有父关系，则可以直接引用父数据源中的字段。引用的语法类似于已经给出的示例 - 您给出数据源的名称，然后是关系名称，然后是字段名称，每个名称之间用小数点或句号分隔，整个内容由大括号。例如：

{数据源.关系.字段}

假设您有一组这样的信息：

• Products是数据源的名称；
• ParentCategories是关系的名称，与两个数据源相关联。在这种情况下，两个数据源是相关的：
• Products是产品列表，Categories是这些产品的类别列表。
• CategoryName是Categories数据源中的列名。

如果您输入以下表达式：

{Products.ParentCategories.CategoryName}

然后经过计算，报告中出现的结果将是产品的类别名称。

您可以在 Stimulsoft 报告中使用的关系数量没有限制。因此可以通过两个或三个甚至更多的关系调用一个列。例如，假设您有一组这样的信息：

• OrderDetails是数据源的名称；
• ParentProducts是OrdersDetails和Products数据源之间的关系名称；
• 父类别。是Products和Categories数据源之间关系的名称；
• CategoryName是Categories数据源中的一个字段。

如果您输入以下表达式：

{OrderDetails.ParentProducts.ParentCategories.CategoryName}

那么经过计算，报表中出现的结果仍然是一个产品的类别名称，但是CategoryName字段的值是通过关系获取的，绕过OrderDetails数据源到达Categories数据源。未使用对类别数据源的直接调用。

重要提示：如果报告语言为C# ，则名称区分大小写。如果报告语言是VB.Net ，则名称不区分大小写。

应该记住，数据源中的所有值都是类型化的。这意味着所有数据项都被动态转换为选项列中指定的类型，这有助于加速报表的开发。但是，如果您需要从列中获取数据而不进行转换，则需要直接指定数据源。例如，在 C# 中：

{产品[“产品名称”]}

此表达式将“按原样”从Products数据源返回数据，而不进行转换。下面的示例显示了VB.Net的相同表达式：

{Products.Item("ProductName")}

Stimulsoft Ultimate | 下载试用

本次的介绍就到这里了，下篇文章将介绍组件属性以及如何在表达式中使用函数相关内容，点击查看全部Stimulsoft Ultimate使用教程。

想要了解或购买Stimulsoft Ultimate正版授权的朋友，欢迎咨询慧都官方客服

---