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