分页报表的表达式中的内置集合（报表生成器）

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

在分页报表的表达式中，可包含对以下内置集合的引用：ReportItems、Parameters、Fields、DataSets、DataSources、Variables 以及全局信息的内置字段（如报表名称）。 并非所有集合都显示在 “表达式” 对话框中。 DataSets 和 DataSources 集合只有在运行时报表将发布到报表服务器之后才可用。 ReportItems 集合是报表区域中的文本框集合，例如页面或页眉中的文本框。

有关详细信息，请参阅表达式（报表生成器和 SSRS）。

注意

在 SQL Server Data Tools 中，你可以在 Microsoft 报表生成器、Power BI 报表生成器和报表设计器中创建和修改分页报表定义 (.rdl) 文件。

了解内置集合

下表列出了在您撰写表达式时可用的内置集合。 无论是否能够使用“表达式”对话框以交互方式添加对集合、示例和包含可用的初始化集合值的说明的引用，每行都包括集合的区分大小写编程名称。

内置集合	“表达式”对话框中的类别	示例	描述
全局	内置字段	=Globals.ReportName - or - =Globals.PageNumber	表示对报表有用的全集变量，如报表名称或页码。 始终可用。 有关详细信息，请参阅内置的全局和用户引用（报表生成器和 SSRS）。
用户	内置字段	=User.UserID - 或 - =User.Language	表示与运行报表的用户有关的数据的集合，如语言设置或用户 ID。 始终可用。 有关详细信息，请参阅内置的全局和用户引用（报表生成器和 SSRS）。
参数	参数	=Parameters("ReportMonth").Value - 或 - =Parameters!ReportYear.Value	表示报表参数的集合，每个参数都可为单值或多值参数。 直到处理初始化完成之后才可用。 有关详细信息，请参阅集合引用（报表生成器和 SSRS）。
Fields(<Dataset>)	字段	=Fields!Sales.Value	表示可用于报表的数据集的字段集合。 将数据从数据源检索到数据集中之后可用。 有关详细信息，请参阅数据集字段集合引用（报表生成器和 SSRS）。
DataSet	不显示	=DataSets("TopEmployees").CommandText	表示从报表定义的主体中引用的数据集的集合。 不包括仅在页眉或页脚中使用的数据源。 无法在本地预览中使用。 有关详细信息，请参阅 DataSources 和 DataSets 集合引用（报表生成器和 SSRS）。
DataSources	不显示	=DataSources("AdventureWorks2022").Type	表示从报表的主体中引用的数据源集合。 不包括仅在页眉或页脚中使用的数据源。 无法在本地预览中使用。 有关详细信息，请参阅 DataSources 和 DataSets 集合引用（报表生成器和 SSRS）。
变量	Variables	=Variables!CustomTimeStamp.Value	表示报表变量和组变量的集合。 有关详细信息，请参阅报表和组变量集合引用（报表生成器和 SSRS）。
ReportItems	不显示	=ReportItems("Textbox1").Value	表示报表项中的文本框集合。 此集合可以用于汇总页面中的项，包括页眉或页脚。 有关详细信息，请参阅 ReportItems 集合引用（报表生成器和 SSRS）。

在表达式中使用集合语法

若要从表达式中引用某个集合，可将标准的 Microsoft Visual Basic 语法用于集合中的项。 下表显示集合语法的示例。

语法	示例
Collection!ObjectName.Property	=Fields!Sales.Value
Collection!ObjectName("Property")	=Fields!Sales("Value")
Collection("ObjectName").Property	=Fields("Sales").Value
Collection("Member")	=User("Language")
Collection.Member	=User.Language

另请参阅

添加表达式（报表生成器和 SSRS）
表达式示例（报表生成器和 SSRS）