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

  • 项目

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

注意

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

语法

  
LookupSet(source_expression, destination_expression, result_expression, dataset)

参数

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

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

result_expression
(Variant) 一个表达式，该表达式针对数据集中 source_expression = destination_expression的行进行计算，并指定要检索的值。 例如，=Fields!PhoneNumber.Value。

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

返回

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

备注

使用 LookupSet 从名称/值对（每对具有 1 对多的关系）的指定数据集中检索一组值。 例如，对于表中的客户标识符，可以使用 LookupSet 从未绑定到该数据区域的数据集检索该客户的所有相关电话号码。

LookupSet 执行下列操作：

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

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

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

  • 返回一组结果表达式值。

若要从具有指定名称的名称/值对（具有 1 对 1 的关系）的数据集中检索单个值，请使用 Lookup 函数（报表生成器和 SSRS）。 若要调用Lookup一组值，请使用 Multilookup 函数 (Report Builder和 SSRS) 。

存在以下限制：

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

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

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

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

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

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

    • 数据集中的计算字段。

    • 数据集中的查询参数。

    • 数据集中的筛选器。

    • 报表参数。

    • Report.Language 属性。

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

示例

在以下示例中，假定将表绑定到包含销售区域标识符 TerritoryGroupID 的数据集。 名为“Stores”的独立数据集包含区域中的所有商店列表以及区域标识符 ID 和商店名称 StoreName。

在以下表达式中，LookupSet 将值 TerritoryGroupID 与名为“Stores”的数据集中每行的 ID 进行比较。 对于每个匹配项，将该行的 StoreName 字段值添加到结果集。

=LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores")

示例

由于 LookupSet 返回对象的集合，因此不能直接在文本框中显示结果表达式。 可以将集合中每个对象的值连接为一个字符串。

使用 Visual Basic 函数 Join 从一组对象创建带分隔符的字符串。 使用逗号作为分隔符来合并一行中的对象。 在某些呈现器中，你可以使用 Visual Basic 换行 (vbCrLF) 作为分隔符以在新行列出每个值。

下面的表达式用作文本框的 Value 属性时，使用 Join 创建列表。

=Join(LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores"),",")

示例

对于仅呈现几次的文本框，您可以选择添加自定义代码来生成 HTML 以显示文本框中的值。 文本框中的 HTML 需要特别处理，因此对于呈现数千次的文本框来说不要这样做。

将以下 Visual Basic 函数复制到报表定义中的代码块。 MakeList 提取在 result_expression 中返回的对象数组并使用 HTML 标记生成未排序的列表。 Length 返回对象数组中的项数。

Function MakeList(ByVal items As Object()) As String  
   If items Is Nothing Then  
      Return Nothing  
   End If  
  
   Dim builder As System.Text.StringBuilder =   
      New System.Text.StringBuilder()  
   builder.Append("<ul>")  
  
   For Each item As Object In items  
      builder.Append("<li>")  
      builder.Append(item)  
   Next  
   builder.Append("</ul>")  
  
   Return builder.ToString()  
End Function  
  
Function Length(ByVal items as Object()) as Integer  
   If items is Nothing Then  
      Return 0  
   End If  
   Return items.Length  
End Function

示例

若要生成 HTML，必须调用该函数。 在文本框的 Value 属性中粘贴以下表达式并将文本的标记类型设置为 HTML。 有关详细信息，请参阅向报表添加 HTML（报表生成器和 SSRS）。

=Code.MakeList(LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores"))

另请参阅

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