First 関数 (レポート ビルダー 3.0 および SSRS)
指定された式の指定されたスコープの最初の値を返します。
.gif "注意") 注 |
|---|
レポート定義 (.rdl) は、Business Intelligence Development Studio のレポート ビルダー 3.0 およびレポート デザイナーで作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、microsoft.com Web サイトの「レポート デザイナーとレポート ビルダー 3.0 でのレポートのデザイン (SSRS)」を参照してください。 |
構文
First(expression, scope)
パラメーター
expression
(Variant または Binary) この集計関数の実行対象の式です (=Fields!FieldName.Value など)。scope
(String) 省略可。集計関数の適用先となるレポート アイテムを含むデータセット、グループ、またはデータ領域の名前です。scope を指定しない場合、現在のスコープが使用されます。
戻り値の型
式の種類によって決まります。
説明
First 関数は、指定されたスコープですべての並べ替えおよびフィルター処理が適用された後、データセットの最初の値を返します。
First 関数は、現在 (既定) のスコープ以外のスコープを使用してグループ化フィルター式で使用することはできません。
また、ページ ヘッダーで First を使用して、ページの ReportItems コレクションから最初の値を返し、各ページの最初と最後のエントリを表示する辞書形式のヘッダーを作成することもできます。
scope の値は文字列定数である必要があり、式にすることはできません。外部の集計または他の集計を指定しない集計では、scope は現在のスコープまたはコンテナー スコープを参照する必要があります。集計の集計では、入れ子になった集計に、子のスコープを指定できます。
Expression には、入れ子になった集計関数への呼び出しを含めることができます。ただし、次に示すように、これには例外および条件があります。
入れ子集計の Scope は、外部集計のスコープと同じであるか、そのスコープに含まれている必要があります。式内のすべてのスコープについては、1 つのスコープがそれ以外のすべてのスコープに対する子であるようなリレーションシップが必要です。
入れ子集計の Scope には、データセット名は使用できません。
Expression には、First、Last、Previous、または RunningValue の各関数を含めることができません。
Expression には、recursive を指定する入れ子集計を含めることができません。
詳細については、「集計関数リファレンス (レポート ビルダー 3.0 および SSRS)」および「合計、集計、および組み込みコレクションの式のスコープについて (レポート ビルダー 3.0 および SSRS)」を参照してください。
再帰的集計の詳細については、「再帰型階層グループの作成 (レポート ビルダー 3.0 および SSRS)」を参照してください。
使用例
次のコード例では、データ領域の Category グループの最初の製品番号が返されます。
=First(Fields!ProductNumber.Value, "Category")