表达式中的内置集合(报表生成器和 SSRS)

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

有关详细信息,请参阅表达式(报表生成器和 SSRS)

注意注意

在 SQL Server Data Tools 中,您可以在报表生成器和报表设计器中创建和修改报表定义 (.rdl)。每个创作环境提供了不同的方式来创建、打开和保存报表和相关项。有关详细信息,请参阅 Web 上 microsoft.com 中的“在报表设计器和报表生成器中设计报表 (SSRS)”。

了解内置集合

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

内置集合

“表达式”对话框中的类别

示例

说明

Globals

内置字段

=Globals.ReportName

- or -

=Globals.PageNumber

表示对报表有用的全集变量,如报表名称或页码。 始终可用。

有关详细信息,请参阅内置的全局和用户引用(报表生成器和 SSRS)

User

内置字段

=User.UserID

- 或 -

=User.Language

表示与运行报表的用户有关的数据的集合,如语言设置或用户 ID。 始终可用。

有关详细信息,请参阅内置的全局和用户引用(报表生成器和 SSRS)

Parameters

参数

=Parameters("ReportMonth").Value

- 或 -

=Parameters!ReportYear.Value

表示报表参数的集合,每个参数都可为单值或多值参数。 直到处理初始化完成之后才可用。 有关详细信息,请参阅Parameters 集合引用(报表生成器和 SSRS)

Fields(<Dataset>)

字段

=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

请参阅

任务

添加表达式(报表生成器和 SSRS)

参考

表达式示例(报表生成器和 SSRS)