通过

  • 项目

First 函数（Report Builder 3.0 和 SSRS）

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

注意注意

在 Business Intelligence Development Studio 中，您可以在 Report Builder 3.0 和报表设计器中创建和修改报表定义 (.rdl)。每个创作环境提供了不同的方式来创建、打开和保存报表和相关项。有关详细信息，请参阅 Web 上 microsoft.com 中的“在报表设计器和 Report Builder 3.0 中设计报表 (SSRS)”。

语法

First(expression, scope)

参数

  • expression
    （Variant 或 Binary）要对其执行聚合的表达式，例如，=Fields!FieldName.Value。

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

返回类型

视表达式的类型而定。

注释

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

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

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

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

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

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

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

  • Expression 不得包含 First、Last、Previous 或 RunningValue 函数。

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

有关详细信息，请参阅聚合函数引用（Report Builder 3.0 和 SSRS） 和了解总计、聚合和内置集合的表达式作用域（Report Builder 3.0 和 SSRS）。

有关递归聚合的详细信息，请参阅创建递归层次结构组（Report Builder 3.0 和 SSRS）。

示例

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

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