共用方式為


第一個函數(報表產生器及 SSRS)

傳回指定表示式指定範圍中的第一個值。

備註

您可以在報表產生器及 SQL Server Data Tools 的報表設計師中建立和修改報表定義 (.rdl)。 每個撰寫環境提供不同的方式來建立、開啟及儲存報表和相關專案。 如需詳細資訊,請至 microsoft.com 網站上查看 報表設計師和報表產生器 (SSRS) 的報表設計

語法

  
First(expression, scope)  

參數

表示式
VariantBinary) 要在其中執行匯總的運算式,例如 =Fields!FieldName.Value

範圍
String) 選擇性。 包含要套用聚合函數之報表項目的數據集、群組或數據區名稱。 如果未指定 scope ,則會使用目前的範圍。

返回類型

由表達式類型決定。

備註

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

First 函數不能用於群組篩選表達式中,只能在目前(預設)範圍中使用。

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

範圍的值必須是字串常數,而且不能是表達式。 對於外部匯總或未指定其他匯總的匯總,範圍 必須參考目前的範圍或所包含的範圍。 針對聚合的聚合,巢狀聚合可以指定子範圍。

運算式 可以包含巢狀聚合函數的呼叫,但有下列例外狀況和條件:

  • 巢狀匯總的範圍必須與外部匯總的範圍相同,或包含在其中。 針對表達式中的所有不同範圍,一個範圍必須位於與所有其他範圍的子關聯性中。

  • 巢狀匯總的範圍不能是數據集的名稱。

  • 表達式 不得包含 FirstLastPreviousRunningValue 函式。

  • 表達式 不能包含指定 遞歸的巢狀匯總。

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

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

範例

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

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

另請參閱

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