• [アーティクル]

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

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

注意注

レポート定義 (.rdl) は、Business Intelligence Development Studio のレポート ビルダー 3.0 およびレポート デザイナーで作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、microsoft.com Web サイトの「レポート デザイナーとレポート ビルダー 3.0 でのレポートのデザイン (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 関数 (レポート ビルダー 3.0 および SSRS)」を参照してください。

詳細については、「集計関数リファレンス (レポート ビルダー 3.0 および SSRS)」および「合計、集計、および組み込みコレクションの式のスコープについて (レポート ビルダー 3.0 および SSRS)」を参照してください。

再帰的集計の詳細については、「再帰型階層グループの作成 (レポート ビルダー 3.0 および SSRS)」を参照してください。

説明

次のコード例では、最も外側のスコープ (データセット) の Cost フィールドの累計が返されます。

コード

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