レポート ビルダー関数 - ページ分割されたレポートの Union 関数 (レポート ビルダー)
適用対象: 
Microsoft レポート ビルダー (SSRS) Power BI Report Builder SQL Server Data Tools のレポート デザイナー
式で指定された NULL 以外のすべての数値の和集合を、ページ分割されたレポートで、指定されたスコープで評価して返します。
注意
ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。
構文
Union(expression, scope, recursive)
パラメーター
式 (expression)
(SqlGeometry または SqlGeography) この集計関数の実行対象の式です。
スコープ (scope)
(文字列) 省略可。 集計関数の適用先となるレポート アイテムを含むデータセット、グループ、またはデータ領域の名前です。 scope を指定しない場合、現在のスコープが使用されます。
再帰
(列挙型) 省略可。 Simple (既定値) または RdlRecursiveです。 集計を再帰的に実行するかどうかを指定します。
戻り値
式の型に応じて、 SqlGeometry または SqlGeographyのいずれかの空間オブジェクトを返します。 SqlGeometry および SqlGeography の空間データ型の詳細については、「 空間データ型の概要」を参照してください。
解説
式で指定されたデータセットは、同じデータ型である必要があります。
scope の値は文字列定数である必要があり、式にすることはできません。 外部の集計または他の集計を指定しない集計では、 scope は現在のスコープまたはコンテナー スコープを参照する必要があります。 データセットのスコープはサポートされません。 集計の集計では、入れ子になった集計に、子のスコープを指定できます。
Expression には、入れ子になった集計関数への呼び出しを含めることができます。ただし、次に示すように、これには例外および条件があります。
入れ子集計のScope は、外部集計のスコープと同じであるか、そのスコープに含まれている必要があります。 式内のすべてのスコープについては、1 つのスコープがそれ以外のすべてのスコープに対する子であるようなリレーションシップが必要です。
入れ子集計のScope には、データセット名は使用できません。
Expression には、 First、 Last、 Previous、または RunningValue の各関数を含めることができません。
Expression には、 recursiveを指定する入れ子集計を含めることができません。
詳細については、「集計関数リファレンス (レポート ビルダーおよび SSRS)」および「合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)」を参照してください。
再帰的集計については、「複数の再帰型階層グループの作成 (レポート ビルダーおよび SSRS)」を参照してください。
例
次の表に、 SqlGeometry 式の例と、それに Union 式を適用した結果を、空間データ用の WKT (Well Known Text) 形式で示します。
| 空間データを含むフィールド | 例 | Union の結果 |
|---|---|---|
| [PointLocation] | POINT(1 2) POINT(3 4) |
MULTIPOINT((1 2), (3 4)) |
| [PathDefinition] | LINESTRING(1 2, 3 4) LINESTRING(5 6, 7 8) |
MULTILINESTRING((7 8, 5 6), (3 4, 1 2)) |
| [PolygonDefinition] | POLYGON((1 2, 3 4, 5 2, 1 2)) POLYGON((-1 2, -3 4, -5 2, -1 2)) |
MULTIPOLYGON(((1 2, 5 2, 3 4, 1 2)), ((-5 2, -1 2, -3 4, -5 2))) |
=Union(Fields!PointLocation.Value)
=Union(Fields!PathDefinition.Value)
=Union(Fields!PolygonDefinition.Value, "Group1")