分页报表中的 ReportItems 集合引用（报表生成器）

适用范围： Microsoft 报表生成器 (SSRS) Power BI Report Builder SQL Server Data Tools 中的报表设计器

“ReportItems”内置集合是报表项的文本框集（如分页报表设计图面上的数据区域的行或文本框）。 ReportItems 集合包括位于表头、表尾或表体的当前作用域中的文本框。 此集合在运行时由报表处理器和报表呈现器确定。 用户查看报表页面时，如果报表处理器连续组合报表数据和报表项布局元素，则当前作用域将随之变化。 可以使用 ReportItems 内置集合在每个页面中生成显示首项和尾项的字典样式页面页眉。

使用 ReportItems 值属性

ReportItems 集合内的项只有一个属性：Value。 ReportItems 项的值可用于显示或计算报表中其他字段的数据。 要访问当前文本框的值，可以使用 Visual Basic 内置全局 Me.Value 或仅使用 Value。 在报表函数（如 First）和聚合函数中使用完全限定语法。

例如：

• 此表达式放置在文本框中时，显示名为 的 ReportItem Textbox1文本框的值：

  =ReportItems!Textbox1.Value

• 此表达式放置在 ReportItem 文本框的 Color 属性中，当值为 > 0 时以黑色显示文本；否则将以红色显示该值：

  =IIF(Me.Value > 0,"Black","Red")

• 此表达式放置在表头或表尾的文本框中时，显示所呈现的报表每一页中名为 LastName的文本框的第一个值：

  =First(ReportItems("LastName").Value)

字典样式表头表达式

可以创建一个表头，显示此页第一个客户和最后一个客户。 因为在一个表达式中，页面页眉中的文本框只能引用一次 ReportItems 内置集合，所以需要在页面页眉添加两个文本框：一个用于第一个客户名称 (=First(ReportItems!textboxLastName.Value)，另一个用于最后一个客户名称 (=Last(ReportItems!textboxLastName.Value)。

在表头或表尾部分，只有当前页中的文本框才能作为 ReportItems 集合的成员。 例如，在多页数据区域中，如果 ReportItems!textboxLastName.Value 引用一个只显示在首页的文本框，则可以在首页看到一个值，其他页则显示 #Error，表明该表达式不能按本文所述进行计算。

ReportItems 集合的作用域

处理报表时，文本框所在数据集、数据区域和组关联的上下文将计算表体或数据区域中的所有文本框。 对 ReportItems 集合的引用的作用域为当前作用域或高于当前作用域的任何点。

例如，位于父组行的文本框不能包含引用子组行的文本框名称的表达式。 子行文本框超出了作用域，所以此类表达式不会解析报表中的值。 有关详细信息，请参阅“聚合函数引用（报表生成器）”。

相关内容

表达式中的内置集合（报表生成器）
表达式示例（报表生成器）
Reporting Services 中的分页 (Report Builder)
对数据进行筛选、分组和排序 (Report Builder)