表开发工具Stimulsoft Report使用教程（十三）：表达式的字典变量以及数据字段

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正版授权的朋友，欢迎咨询官方客服

标签：