レポート ビルダー関数 - ページ分割されたレポートの First 関数 (レポート ビルダー)
適用対象: 
Microsoft レポート ビルダー (SSRS) Power BI Report Builder SQL Server Data Tools のレポート デザイナー
ページ分割されたレポートで指定された式の指定されたスコープの最初の値を返します。
注意
ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。
構文
First(expression, scope)
パラメーター
式 (expression)
(Variant または Binary) この集計関数の実行対象の式です ( =Fields!FieldName.Valueなど)。
スコープ (scope)
(文字列) 省略可。 集計関数の適用先となるレポート アイテムを含むデータセット、グループ、またはデータ領域の名前です。 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")