第一个函数(报表生成器和 SSRS)

返回指定表达式的给定作用域中的第一个值。

注释

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

语法

  
First(expression, scope)  

参数

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

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

返回类型

视表达式的类型而定。

注解

First 函数在指定范围应用了所有排序和筛选之后,返回一组数据中的第一个值。

First 函数不能用于除当前(默认)作用域以外的任何内容的组筛选器表达式中。

还可以在 First 页眉中使用,以返回页面集合中的第一个值 ReportItems ,以便生成显示页面上第一个和最后一个条目的字典样式标题。

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

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

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

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

  • 表达式不能包含FirstLastPreviousRunningValue函数。

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

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

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

示例:

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

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

另请参阅

在报表中使用表达式(报表生成器和 SSRS)
表达式示例(报表生成器和 SSRS)
表达式中的数据类型(报表生成器和 SSRS)
总计、聚合和内置集合的表达式作用域(报表生成器和 SSRS)