Report Builder 函數 - 編頁報表中的 RunningValue 函數 (報表產生器)

適用於:Microsoft 報表產生器 (SSRS) Power BI Report Builder SQL Server Data Tools 中的報表設計師

傳回運算式所指定之所有非 Null 數值的累計彙總,這些數值會針對分頁報表中的指定範圍進行評估。

注意

您可以在 Microsoft 報表產生器、Power BI Report Builder,以及 SQL Server Data Tools 的報表設計師中,建立及修改編頁報告定義 (.rdl) 檔案。

語法

  
RunningValue(expression, function, scope)  

參數

expression
要用來執行彙總運算的運算式,例如 [Quantity]。

函數
(Enum) 運算式所要套用的彙總函式名稱,例如 Sum。 此函式不可為RunningValue、RowNumber或Aggregate。

範圍
(String) 字串常數是資料集、資料區或群組的名稱,或為 Null (在 Visual Basic 中為 Nothing),可指定要在其中評估彙總的內容。 Nothing 指定最外層的內容,這通常為報表資料集。

傳回類型

取決於 function 參數所指定的彙總函式。

備註

RunningValue 的值在範圍的每個新執行個體中都會重設為 0。 如果已指定群組,當群組運算式變更時,執行中的值也會重設。 如果指定了資料區域,則每當資料區域有新的執行個體時,都會重設累計值。 如果已指定資料集,則整個資料集不會重設執行中的值。

RunningValue 不能用於篩選或排序運算式。

評估執行值的資料集合必須具有相同的資料類型。 若要將具有多個數值資料類型的資料轉換成相同的資料類型,請使用 CInt、 CDbl 或 CDec等轉換函數。 如需詳細資訊,請參閱 類型轉換函數。

Scope 不能是運算式。

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

  • 巢狀彙總的範圍必須與外部彙總的範圍相同或是由外部彙總的範圍所限制。 對於表達式中的所有相異範疇,其中一個範疇必須與所有其他範疇都具有子系關係。

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

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

  • 運算式 不得包含指定 recursive 的巢狀彙總函式。

若要計算資料列數的執行值,請使用 RowNumber。 如需詳細資訊,請參閱 RowNumber 函式 (報表產生器及 SSRS)。

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

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

範例

下列程式碼範例提供最外層範圍中 (也就是資料集) 名為 Cost 的欄位之執行總和。

=RunningValue(Fields!Cost.Value, Sum, Nothing)  

下列程式碼範例提供名為 Score 的資料集中名為 DataSet1的欄位之累計總和。

=RunningValue(Fields!Score.Value,sum,"DataSet1")  

下列程式碼範例提供最大範圍中名為 Traffic Charges 的欄位之累計總和。

=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)