表达式中的内置集合（报表生成器和 SSRS）
在报表的表达式中，可以包含对以下内置集合的引用：ReportItems、Parameters、Fields、DataSets、DataSources、Variables 和全局信息的内置字段（如报表名称）。 并非所有集合都显示在 “表达式” 对话框中。 DataSets 和 DataSources 集合只有在运行时报表将发布到报表服务器之后才可用。 ReportItems 集合是报表区域中的文本框集合，例如页面或页眉中的文本框。
有关详细信息，请参阅表达式（报表生成器和 SSRS）。
注意
可以在 SQL Server Data Tools 中的报表生成器和报表设计器中创建和修改报表定义（.rdl）。 每个创作环境提供了不同的方式来创建、打开和保存报表和相关项。 有关详细信息，请参阅 microsoft.com 上的 报表设计器 和 报表生成器 （SSRS） 中的“设计报表”。
了解内置集合
下表列出了在您撰写表达式时可用的内置集合。 无论是否能够使用“表达式”对话框以交互方式添加对集合、示例和包含可用的初始化集合值的说明的引用，每行都包括集合的区分大小写编程名称。
| 内置集合 | “表达式”对话框中的类别 | 示例 | 说明 |
|---|---|---|---|
Globals |
内置字段 | =Globals.ReportName- or -=Globals.PageNumber |
表示对报表有用的全集变量，如报表名称或页码。 始终可用。 有关详细信息，请参阅内置的全局和用户引用（报表生成器和 SSRS）。 |
User |
内置字段 | =User.UserID- 或 - =User.Language |
表示与运行报表的用户有关的数据的集合，如语言设置或用户 ID。 始终可用。 有关详细信息，请参阅内置的全局和用户引用（报表生成器和 SSRS）。 |
Parameters |
参数 | =Parameters("ReportMonth").Value- 或 - =Parameters!ReportYear.Value |
表示报表参数的集合，每个参数都可为单值或多值参数。 直到处理初始化完成之后才可用。 有关详细信息，请参阅集合引用（报表生成器和 SSRS）。 |
Fields(<数据> ) |
字段 | =Fields!Sales.Value |
表示可用于报表的数据集的字段集合。 将数据从数据源检索到数据集中之后可用。 有关详细信息，请参阅数据集字段集合引用（报表生成器和 SSRS）。 |
DataSets |
不显示 | =DataSets("TopEmployees").CommandText |
表示从报表定义的主体中引用的数据集的集合。 不包括仅在页眉或页脚中使用的数据源。 无法在本地预览中使用。 有关详细信息，请参阅 DataSources 和 DataSets 集合引用（报表生成器和 SSRS）。 |
DataSources |
不显示 | =DataSources("AdventureWorks2012").Type |
表示从报表的主体中引用的数据源集合。 不包括仅在页眉或页脚中使用的数据源。 无法在本地预览中使用。 有关详细信息，请参阅 DataSources 和 DataSets 集合引用（报表生成器和 SSRS）。 |
Variables |
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 |