報表產生器函數 - 在編頁報告中使用 Multilookup 函數 (報表產生器)

  • 發行項

適用於： Microsoft 報表產生器 (SSRS) Power BI Report Builder SQL Server Data Tools 中的報表設計師

在編頁報告中從包含名稱/值組的資料集傳回第一組符合指定名稱集合的值。

注意

您可以在 Microsoft 報表產生器、Power BI Report Builder，以及 SQL Server Data Tools 的報表設計師中，建立及修改編頁報告定義 (.rdl) 檔案。

語法

  
Multilookup(source_expression, destination_expression, result_expression, dataset)

參數

source_expression
(VariantArray) 在目前範圍中評估並指定要查閱之名稱或索引鍵集合的運算式。 例如，如果是多值參數 =Parameters!IDs.value。

destination_expression
(Variant) 針對資料集中的每個資料列評估並指定要比對之名稱或索引鍵的運算式。 例如： =Fields!ID.Value 。

result_expression
(Variant) 對資料集的每個資料列進行評估，而且指定要擷取之值的運算式，其中 source_expression = destination_expression。 例如： =Fields!Name.Value 。

資料集 (dataset)
指定報表中資料集名稱的常數。 例如，"Colors"。

傳回

傳回 VariantArray或在沒有相符項目時傳回 Nothing 。

備註

使用 Multilookup 可從具有一對一關聯性的每一組名稱/值組的資料集內擷取一組值。 MultiLookup 等於針對一組名稱或索引鍵呼叫 Lookup 。 例如，如果是根據主索引鍵識別碼的多值參數，您可以在資料表中的文字方塊內使用運算式中的 Multilookup ，從未繫結至參數或資料表的資料集擷取關聯的值。

Multilookup 會執行下列動作：

  • 評估目前範圍中的來源運算式，並產生變數物件的陣列。

  • 對於陣列中的每一個物件，呼叫 Lookup 函數 (報表產生器和 SSRS)，並將結果新增至傳回陣列。

  • 傳回結果集。

若要從具有一對一關聯性之名稱/值組的資料集中，擷取指定名稱的單一值，請使用 Lookup 函數 (報表產生器和 SSRS)。 若要從具有一對多關聯性之名稱/值組的資料集中，擷取某個名稱的多個值，請使用 LookupSet 函數 (報表產生器和 SSRS)。

適用以下限制：

  • 當套用所有篩選運算式之後，便會評估Multilookup 。

  • 只支援一層的查閱。 來源、目的地或結果運算式不能包含查閱函數的參考。

  • 來源和目的地運算式必須評估為相同的資料類型。

  • 來源、目的地和結果運算式無法包含報表或群組變數的參考。

  • Multilookup 不能當做下列報表項目的運算式使用：

    • 資料來源的動態連接字串。

    • 資料集中的導出欄位。

    • 資料集中的查詢參數。

    • 資料集中的篩選。

    • 報表參數。

    • Report.Language 屬性。

如需詳細資訊，請參閱彙總函式參考 (報表產生器和 SSRS) 和總計、彙總與內建集合的運算式範圍 (報表產生器和 SSRS)。

範例

A. 使用 MultiLookup 函數

假設資料集 "Category" 包含 CategoryList 欄位，這個欄位包含以逗號分隔的類別目錄識別碼清單，例如 "2, 4, 2, 1"。

CategoryNames 資料集包含類別目錄識別碼和類別目錄名稱，如下表所示。

ID 名稱
1 Accessories
2 Bikes
3 Clothing
4 元件

若要查閱對應到識別碼清單的名稱，請使用 Multilookup。 您必須先將此清單分割成字串陣列、呼叫 Multilookup 來擷取類別目錄名稱，並將結果串連成一個字串。

當下列運算式置於繫結至 Category 資料集之資料區中的文字方塊內時，將會顯示 "Bikes, Components, Bikes, Accessories"：

=Join(MultiLookup(Split(Fields!CategoryList.Value,","),  
   Fields!CategoryID.Value,Fields!CategoryName.Value,"Category")),  
   ", ")

B. 使用具有多重值參數的 MultiLookup

假設 ProductColors 資料集包含色彩識別碼欄位 ColorID 及色彩值欄位 Color，如下表所示。

ColorID Color
1 紅色
2 藍色
3 綠色

假設多值參數 MyColors 沒有繫結至其可用值的資料集。 此參數的預設值為 2 和 3。 當下列運算式置於資料表的文字方塊中時，會將此參數的多個選定值串連成一個以逗號分隔的清單，並顯示 "Blue, Green"。

=Join(MultiLookup(Parameters!MyColors.Value,Fields!ColorID.Value,Fields!Color.Value,"ProductColors"),", ")

另請參閱

報表中的運算式用法 (報表產生器及 SSRS)
運算式範例 (報表產生器及 SSRS)
運算式中的資料類型 (報表產生器及 SSRS)
總計、彙總與內建集合的運算式範圍 (報表產生器及 SSRS)