報表產生器函數 - 編頁報表中的第一個函式 (報表產生器)
適用於：
Microsoft 報表產生器 (SSRS) Power BI Report Builder 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")