• 發行項

First 函數 (報表產生器 3.0 和 SSRS)

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

[!附註]

您可以在 Business Intelligence Development Studio 中的報表產生器 3.0 及報表設計師中建立及修改報表定義 (.rdl)。每一個撰寫環境都提供了不同的方式讓您建立、開啟，以及儲存報表和相關的項目。如需詳細資訊，請參閱在報表設計師及報表產生器 3.0 (SSRS) 中設計報表，位於 microsoft.com 網站上。

語法

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 的巢狀彙總。

如需詳細資訊，請參閱＜彙總函式參考 (報表產生器 3.0 和 SSRS)＞和＜了解總計、彙總與內建集合的運算式範圍 (報表產生器 3.0 和 SSRS)＞。

如需有關遞迴彙總的詳細資訊，請參閱＜建立遞迴階層群組 (報表產生器 3.0 和 SSRS)＞。

範例

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

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