傳回所指定運算式給定範圍中的第一個值。
注意
您可以在報表產生器以及 SQL Server Data Tools 的報表設計師中建立和修改報表定義 (.rdl)。 每種撰寫環境都會提供不同的方式來建立、開啟和儲存報表與相關的項目。 如需詳細資訊,請參閱在 Web 上設計報表設計師和Report Builder (SSRS) 的報表microsoft.com。
語法
First(expression, scope)
參數
expression
(Variant
或 Binary
) 要執行彙總的運算式,例如 =Fields!FieldName.Value
。
範圍 (scope)
(String
) 選擇性。 包含要套用彙總函式之報表項目的資料集、群組或資料區的名稱。 如果未指定 scope ,則使用目前的範圍。
傳回類型
由運算式的類型決定。
備註
First
函數會在指定的範圍已套用過所有的排序和篩選之後,傳回一組資料中的第一個值。
First
函數無法在群組篩選運算式中使用目前 (預設) 範圍以外的範圍。
您也可以在頁首中使用 First
,從頁面的 ReportItems
集合傳回第一個值,以產生會顯示頁面上第一個及最後一個項目的字典樣式標題。
scope 的值必須是字串常數,而且不得為運算式。 如果是未指定其他彙總的外部彙總, scope 必須參考目前的範圍或是包含的範圍。 如果是彙總的彙總,巢狀彙總可以指定子範圍。
Expression 可以包含巢狀彙總函式的呼叫,其中包含下列例外和條件:
巢狀彙總的Scope 必須與外部彙總的範圍相同或是由外部彙總的範圍所限制。 如果是運算式中的所有相異範圍,一個範圍必須與所有其他範圍之間具有子關聯性。
巢狀彙總的Scope 不得為資料集的名稱。
運算式 不得包含
First
、Last
、Previous
或RunningValue
函式。Expression 不得包含指定 recursive的巢狀彙總。
如需詳細資訊,請參閱彙總函式參考 (報表產生器和 SSRS) 和總計、彙總與內建集合的運算式範圍 (報表產生器和 SSRS)。
如需遞迴彙總的詳細資訊,請參閱建立遞迴階層群組 (報表產生器和 SSRS)。
範例
下列程式碼範例會傳回資料區域的 Category
群組中的第一個產品號碼:
=First(Fields!ProductNumber.Value, "Category")
另請參閱
報表中的運算式用法 (報表產生器及 SSRS)
運算式範例 (報表產生器及 SSRS)
運算式中的資料類型 (報表產生器及 SSRS)
總計、彙總與內建集合的運算式範圍 (報表產生器及 SSRS)