Lookup 函数（报表生成器和 SSRS）

  • 项目

从包含名称/值对的数据集返回指定名称的第一个匹配值。

注意

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

语法

  
Lookup(source_expression, destination_expression, result_expression, dataset)

参数

source_expression
(Variant) 在当前作用域中计算结果并指定要查找的名称或键的表达式。 例如，=Fields!ProdID.Value。

destination_expression
(Variant) 针对数据集中的每行计算结果并指定要匹配的名称或键的表达式。 例如，=Fields!ProductID.Value。

result_expression
() 为数据集中source_expression destination_expression = 行计算的表达式，用于指定要检索的值。Variant 例如，=Fields!ProductName.Value。

数据集 (dataset)
指定报表中数据集的名称的常量。 例如，“Products”。

返回

返回 Variant，如果没有匹配项，则返回 Nothing。

注解

使用 Lookup 从指定的数据集中为名称-值对（每对具有 1 对 1 关系）检索值。 例如，对于表中的 ID 字段，可以使用 Lookup 从未绑定到该数据区域的数据集检索对应的名称字段。

Lookup 执行下列操作：

  • 计算当前作用域中源表达式的结果。

  • 根据指定数据集的排序规则，在应用筛选器后对指定数据集的每行计算目标表达式的结果。

  • 对于源表达式和目标表达式的第一个匹配，计算数据集中该行的结果表达式。

  • 返回结果表达式值。

若要为单个名称或键字段检索多个值（具有 1 对多关系），请使用LookupSet 函数（报表生成器和 SSRS）。 若要调用Lookup一组值，请使用 Multilookup 函数 (Report Builder 和 SSRS) 。

存在以下限制：

  • 在应用所有筛选表达式后计算 Lookup 的结果。

  • 只支持一个级别的查找。 源、目标或结果表达式不能包含对查找函数的引用。

  • 源和目标表达式必须对同一数据类型计算结果。 返回类型和计算后的结果表达式的数据类型相同。

  • 源、目标和结果表达式不能包含对报表或组变量的引用。

  • Lookup 不能作为以下报表项的表达式：

    • 数据源的动态连接字符串。

    • 数据集中的计算字段。

    • 数据集中的查询参数。

    • 数据集中的筛选器。

    • 报表参数。

    • Report.Language 属性。

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

示例

在以下示例中，假定将某个表绑定到包含一个用于产品标识符 ProductID 的字段的数据集。 一个单独的称为“Product”的数据集包含相应的产品标识符“ID”和产品名称“名称”。

在下面的表达式中，Lookup 将 ProductID 的值与名为“Product”的数据集的每行中的 ID 进行比较，当找到匹配项后，为该行返回“名称”字段的值。

=Lookup(Fields!ProductID.Value, Fields!ID.Value, Fields!Name.Value, "Product")

另请参阅

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