Lookup 函数（Report Builder 3.0 和 SSRS）

语法

Lookup(source_expression, destination_expression, result_expression, dataset)

参数

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

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

• result_expression
  (Variant) 针对数据集中的行计算结果并指定要检索的值的表达式，其中 source_expression = destination_expression。例如，=Fields!ProductName.Value。

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

返回

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

注释

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

Lookup 执行下列操作：

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

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

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

• 返回结果表达式值。

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

存在下列限制：

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

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

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

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

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

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

  • 数据集中的计算字段。

  • 数据集中的查询参数。

  • 数据集中的筛选器。

  • 报表参数。

  • Report.Language 属性。

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

示例

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

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

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

请参阅

参考

概念