First 関数 (レポート ビルダーおよび SSRS)
指定された式の指定されたスコープの最初の値を返します。
.gif "注意") 注 |
|---|
SQL Server データ ツールのレポート ビルダーまたはレポート デザイナーを使用して、レポート定義 (.rdl) を作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、microsoft.com Web サイトの「レポート デザイナーおよびレポート ビルダーを使用したレポートのデザイン (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 を指定する入れ子集計を含めることができません。
詳細については、「集計関数リファレンス (レポート ビルダーおよび SSRS)」および「合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)」を参照してください。
再帰的集計の詳細については、「複数の再帰型階層グループの作成 (レポート ビルダーおよび SSRS)」を参照してください。
使用例
次のコード例では、データ領域の Category グループの最初の製品番号が返されます。
=First(Fields!ProductNumber.Value, "Category")
関連項目
参照
概念
レポートでの式の使用 (レポート ビルダーおよび SSRS)