Report Builder 函數-編頁報表中的第一個函數 (Report Builder)

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

在分頁報表中,傳回指定之運算式指定範圍內的第一個值。

注意

您可以在 Microsoft Report Builder、 Power BI Report Builder和報表設計師的 SQL Server Data Tools 中,建立和修改分頁報表定義 ( .rdl) 檔案。

語法

  
First(expression, scope)  

參數

expression
(變數二進位) 要執行彙總的運算式,例如 =Fields!FieldName.Value

範圍 (scope)
(字串) 選擇性。 包含要套用彙總函式之報表項目的資料集、群組或資料區的名稱。 如果未指定 scope ,則使用目前的範圍。

傳回類型

由運算式的類型決定。

備註

First 函數會在指定的範圍已套用過所有的排序和篩選之後,傳回一組資料中的第一個值。

First 函數無法在群組篩選運算式中使用目前 (預設) 範圍以外的範圍。

您也可以在頁首中使用 First ,從頁面的 ReportItems 集合傳回第一個值,以產生會顯示頁面上第一個及最後一個項目的字典樣式標題。

scope 的值必須是字串常數,而且不得為運算式。 如果是未指定其他彙總的外部彙總, scope 必須參考目前的範圍或是包含的範圍。 如果是彙總的彙總,巢狀彙總可以指定子範圍。

Expression 可以包含巢狀彙總函式的呼叫,其中包含下列例外和條件:

  • 巢狀彙總的 Scope 必須與外部彙總的範圍相同或是由外部彙總的範圍所限制。 如果是運算式中的所有相異範圍,一個範圍必須與所有其他範圍之間具有子關聯性。

  • 巢狀彙總的 Scope 不得為資料集的名稱。

  • Expression 不得包含 FirstLastPreviousRunningValue 函數。

  • Expression 不得包含指定 recursive 的巢狀彙總。

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

如需遞迴彙總的詳細資訊,請參閱建立遞迴階層群組 (報表產生器及 SSRS)

範例

下列程式碼範例會傳回資料區域的 Category 群組中的第一個產品號碼:

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

另請參閱

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