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