RunningValue 関数 (レポート ビルダーおよび SSRS)
式で指定された NULL 以外のすべての数値の実行中の集計を、指定されたスコープに対して評価して返します。
注 |
---|
SQL Server データ ツールのレポート ビルダーまたはレポート デザイナーを使用して、レポート定義 (.rdl) を作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、microsoft.com Web サイトの「レポート デザイナーおよびレポート ビルダーを使用したレポートのデザイン (SSRS)」を参照してください。 |
構文
RunningValue(expression, function, scope)
パラメーター
expression
この集計関数の実行対象の式です ([Quantity] など)。function
(Enum) 式に適用する集計関数の名前です (Sum など)。 この関数は、RunningValue、RowNumber、または Aggregate にすることはできません。scope
(String) 集計を評価するコンテキストを示すデータセット、データ領域、またはグループの名前である文字列定数か、NULL (Visual Basic では Nothing) です。 Nothing は、最も外側のコンテキスト (通常はレポート データセット) を示します。
戻り値の型
function パラメーターに指定された集計関数によって決まります。
説明
RunningValue の値は、スコープの新しいインスタンスごとに 0 にリセットされます。 グループが指定された場合は、累計値はグループ式の変更時にリセットされます。 データ領域が指定された場合は、累計値はデータ領域の新しいインスタンスごとにリセットされます。 データセットが指定された場合は、累計値はデータセット全体にわたってリセットされません。
RunningValue は、フィルター式または並べ替え式では使用できません。
実行中の値が計算される一連のデータは、同じデータ型である必要があります。 複数の数値データ型のデータを同じデータ型に変換するには、CInt、CDbl、CDec などの変換関数を使用します。 詳細については、「データ型変換関数」を参照してください。
Scope には、式を指定することはできません。
Expression には、入れ子になった集計関数への呼び出しを含めることができます。ただし、次に示すように、これには例外および条件があります。
入れ子集計のスコープは、外部集計のスコープと同じであるか、そのスコープに含まれている必要があります。 式内のすべてのスコープについては、1 つのスコープがそれ以外のすべてのスコープに対する子であるようなリレーションシップが必要です。
入れ子集計のスコープには、データセット名は使用できません。
Expression には、First、Last、Previous、または RunningValue の各関数を含めることができません。
Expression には、recursive を指定する入れ子集計を含めることができません。
行数の累計値を計算するには、RowNumber を使用します。 詳細については、「RowNumber 関数 (レポート ビルダーおよび SSRS)」を参照してください。
詳細については、「集計関数リファレンス (レポート ビルダーおよび SSRS)」および「合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)」を参照してください。
再帰的集計の詳細については、「複数の再帰型階層グループの作成 (レポート ビルダーおよび SSRS)」を参照してください。
説明
次のコード例では、最も外側のスコープ (データセット) の Cost フィールドの累計が返されます。
コード
=RunningValue(Fields!Cost.Value, Sum, Nothing)
関連項目
参照
概念
レポートでの式の使用 (レポート ビルダーおよび SSRS)