报表生成器函数 - 分页报表中的 First 函数(报表生成器)

适用于: Microsoft 报表生成器 (SSRS) Power BI 报表生成器 SQL Server Data Tools 中的报表生成器

返回分页报表中指定表达式的给定范围中的第一个值。

注意

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

语法

  
First(expression, scope)  

参数

expression
VariantBinary)要对其执行聚合的表达式,例如, =Fields!FieldName.Value

作用域
(String) 可选。 包含要对其应用聚合函数的报表项的数据集、组或数据区域的名称。 如果未指定 scope ,则使用当前作用域。

返回类型

视表达式的类型而定。

备注

First 函数返回在指定作用域中应用所有排序和筛选后的一组数据的第一个值。

First 函数只能用在当前作用域(默认)相关的组筛选表达式中。

还可在页眉中使用 First 函数,返回 ReportItems 集合中属于某页面的第一个值,以便在页面中生成显示首项和尾项的字典样式标题。

scope 的值必须是字符串常量,不能是表达式。 对于外部聚合或未指定其他聚合的聚合, scope 必须引用当前作用域或包含作用域。 对于聚合的聚合,嵌套聚合可以指定子作用域。

Expression 可以包含对嵌套聚合函数的调用,但具有以下例外和条件:

  • 嵌套聚合的Scope 必须与外部聚合的作用域相同,或者包含在外部聚合的作用域中。 对于表达式中的所有非重复作用域,一个作用域必须相对所有其他作用域处于子关系中。

  • 嵌套聚合的Scope 不能为数据集的名称。

  • Expression 不得包含 FirstLastPreviousRunningValue 函数。

  • Expression 不得包含用于指定 recursive的嵌套聚合。

有关详细信息,请参阅聚合函数引用(报表生成器和 SSRS)总计、聚合和内置集合的表达式作用域(报表生成器和 SSRS)

有关递归聚合的详细信息,请参阅创建递归层次结构组(报表生成器和 SSRS)

示例

下面的代码示例返回数据区域 Category 组中的第一个产品编号:

=First(Fields!ProductNumber.Value, "Category")