報表產生器函數 - 編頁報表中的第一個函式 (報表產生器)

  • 發行項

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

傳回編頁報表中所指定運算式給定範圍中的第一個值。

注意

您可以在 Microsoft 報表產生器、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 不得包含 First、 Last、 Previous或 RunningValue 函數。

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

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

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

範例

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

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

另請參閱

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