返回指定表达式的给定作用域中的第一个值。
注释
可以在报表生成器和 SQL Server Data Tools 中的报表设计器中创建和修改报表定义(.rdl)。 每个创作环境提供了创建、打开和保存报表和相关项的不同方法。 有关详细信息,请参阅 microsoft.com Web 上的 报表设计器和报表生成器(SSRS)中设计报表 。
语法
First(expression, scope)
参数
expression
(Variant 或 Binary) 要对其执行聚合的表达式,例如 =Fields!FieldName.Value。
作用域
(String) 可选。 包含要对其应用聚合函数的报表项的数据集、组或数据区域的名称。 如果未指定 scope ,则使用当前作用域。
返回类型
视表达式的类型而定。
注解
该 First 函数在指定范围应用了所有排序和筛选之后,返回一组数据中的第一个值。
该 First 函数不能用于除当前(默认)作用域以外的任何内容的组筛选器表达式中。
还可以在 First 页眉中使用,以返回页面集合中的第一个值 ReportItems ,以便生成显示页面上第一个和最后一个条目的字典样式标题。
范围的值必须是字符串常量,不能是表达式。 对于外部聚合或未指定其他聚合的聚合, scope 必须引用当前作用域或包含作用域。 对于聚合的聚合,嵌套聚合可以指定子作用域。
Expression 可以包含对嵌套聚合函数的调用,但具有以下例外和条件:
嵌套聚合的Scope 必须与外部聚合的作用域相同,或者包含在外部聚合的作用域中。 对于表达式中的所有非重复作用域,一个作用域必须相对所有其他作用域处于子关系中。
嵌套聚合的Scope 不能为数据集的名称。
表达式不能包含
First、Last或PreviousRunningValue函数。Expression 不得包含用于指定 recursive的嵌套聚合。
有关详细信息,请参阅聚合函数引用(报表生成器和 SSRS)和总计、聚合和内置集合的表达式作用域(报表生成器和 SSRS)。
有关递归聚合的详细信息,请参阅创建递归层次结构组(报表生成器和 SSRS)。
示例:
下面的代码示例返回数据区域 Category 组中的第一个产品编号:
=First(Fields!ProductNumber.Value, "Category")
另请参阅
在报表中使用表达式(报表生成器和 SSRS)
表达式示例(报表生成器和 SSRS)
表达式中的数据类型(报表生成器和 SSRS)
总计、聚合和内置集合的表达式作用域(报表生成器和 SSRS)