共用方式為


First 函數 (報表產生器及 SSRS)

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

[!附註]

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

語法

First(expression, scope)

參數

  • expression
    (Variant 或 Binary) 要執行彙總的運算式,例如 =Fields!FieldName.Value。

  • scope
    (String) 選擇性。 包含要套用彙總函式之報表項目的資料集、群組或資料區的名稱。 如果未指定 scope,則使用目前的範圍。

傳回類型

由運算式的類型決定。

備註

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

First 函數無法在群組篩選運算式中使用目前 (預設) 範圍以外的範圍。

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

scope 的值必須是字串常數,而且不得為運算式。 如果是未指定其他彙總的外部彙總,scope 必須參考目前的範圍或是包含的範圍。 如果是彙總的彙總,巢狀彙總可以指定子範圍。

Expression 可以包含巢狀彙總函式的呼叫,其中包含下列例外和條件:

  • 巢狀彙總的 Scope 必須與外部彙總的範圍相同或是由外部彙總的範圍所限制。 如果是運算式中的所有相異範圍,一個範圍必須與所有其他範圍之間具有子關聯性。

  • 巢狀彙總的 Scope 不得為資料集的名稱。

  • Expression 不得包含 First、Last、Previous 或 RunningValue 函數。

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

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

如需有關遞迴彙總的詳細資訊,請參閱<建立多個遞迴階層群組 (報表產生器 3.0 及 SSRS)>。

範例

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

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

請參閱

參考

運算式範例 (報表產生器及 SSRS)

概念

報表中的運算式用法 (報表產生器及 SSRS)

運算式中的資料類型 (報表產生器及 SSRS)

總計、彙總與內建集合的運算式範圍 (報表產生器及 SSRS)