RunningValue 関数 (レポート ビルダーおよび SSRS)

式で指定された NULL 以外のすべての数値の実行中の集計を、指定されたスコープに対して評価して返します。

注

レポート定義 (.rdl) は、レポート ビルダーと SQL Server Data Tools のレポート デザイナーで作成および変更できます。 作成環境ごとに、レポートと関連アイテムを作成、開く、保存するさまざまな方法が用意されています。 詳細については、Web 上の microsoft.com にある レポート デザイナーおよびレポート ビルダー (SSRS) でのレポートのデザイン を参照してください。

構文

  
RunningValue(expression, function, scope)  

パラメーター

式
この集計関数の実行対象の式です ( [Quantity]など)。

機能
(Enum) 式に適用する集計関数の名前 (例: Sum)。 この関数は、 RunningValue、 RowNumber、または Aggregateすることはできません。

スコープ
(String) 集計を評価するコンテキストを指定する、データセット、データ領域、またはグループの名前、または null (Visual Basic では Nothing ) の文字列定数。 Nothing は、最も外側のコンテキスト (通常はレポート データセット) を指定します。

返り値の種類

function パラメーターに指定された集計関数によって決まります。

注釈

RunningValueの値は、スコープの新しいインスタンスごとに 0 にリセットされます。 グループが指定された場合は、累計値はグループ式の変更時にリセットされます。 データ領域が指定された場合は、累計値はデータ領域の新しいインスタンスごとにリセットされます。 データセットが指定された場合は、累計値はデータセット全体にわたってリセットされません。

RunningValue は、フィルター式または並べ替え式では使用できません。

実行中の値が計算される一連のデータは、同じデータ型である必要があります。 複数の数値データ型を持つデータを同じデータ型に変換するには、 CInt、 CDbl 、 CDecなどの変換関数を使用します。 詳細については、「 データ型変換関数」を参照してください。

Scope には、式を指定することはできません。

Expression には、入れ子になった集計関数への呼び出しを含めることができます。ただし、次に示すように、これには例外および条件があります。

  • 入れ子集計のスコープは、外部集計のスコープと同じであるか、そのスコープに含まれている必要があります。 式内のすべてのスコープについては、1 つのスコープがそれ以外のすべてのスコープに対する子であるようなリレーションシップが必要です。

  • 入れ子集計のスコープには、データセット名は使用できません。

  • 式 には、 First、 Last、 Previous、または RunningValue 関数を含めてはなりません。

  • Expression には、 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)  

こちらもご覧ください

レポートでの式の使用 (レポート ビルダーおよび SSRS)
式の例 (レポート ビルダーおよび SSRS)
式で使用されるデータ型 (レポート ビルダーおよび SSRS)
合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)