Union-Funktion (Berichts-Generator und SSRS)
Gibt die Vereinigung aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des festgelegten Bereichs ausgewertet zurück.
Hinweis
Sie können Berichtsdefinitionen (RDL) in Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Methoden zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten in Berichts-Designer und Report Builder (SSRS) im Web unter microsoft.com.
Syntax
Union(expression, scope, recursive)
Parameter
expression
(SqlGeometry oder SqlGeography) Der Ausdruck, für den die Aggregation ausgeführt werden soll.
scope
(String) optional. Der Name eines Datasets, einer Gruppe oder eines Datenbereichs mit den Berichtselementen, auf die die Aggregatfunktion anzuwenden ist. Wenn scope nicht angegeben ist, wird der aktuelle Bereich verwendet.
recursive
(Enumerationstyp) Optional. Simple (Standardwert) oder RdlRecursive. Gibt an, ob die Aggregation rekursiv auszuführen ist.
Rückgabewert
Gibt ein räumliches Objekt zurück. Dies ist je nach Ausdruckstyp vom Typ SqlGeometry oder SqlGeography. Weitere Informationen zu SqlGeometry und SqlGeography räumlichen Datentypen finden Sie unter Übersicht über räumliche Datentypen.
Bemerkungen
Die im Ausdruck angegebene Gruppe von Daten muss über den gleichen Datentyp verfügen.
Der Wert des scope -Objekts muss eine Zeichenfolgenkonstante sein und darf kein Ausdruck sein. Für äußere Aggregate oder Aggregate, die keine anderen Aggregate angeben, muss das scope -Objekt auf den aktuellen Bereich oder einen enthaltenen Bereich verweisen. Datasetbereiche werden nicht unterstützt. Bei Aggregaten von Aggregaten können geschachtelte Aggregate einen untergeordneten Bereich angeben.
DasExpression -Objekt kann Aufrufe von geschachtelten Aggregatfunktionen enthalten. Dabei gelten folgende Ausnahmen und Bedingungen:
DasScope -Objekt für geschachtelte Aggregate muss dem Bereich des äußeren Aggregats entsprechen oder darin enthalten sein. In allen eindeutigen Bereichen des Ausdrucks muss ein Bereich eine untergeordnete Beziehung zu allen anderen Bereichen haben.
DasScope -Objekt für geschachtelte Aggregate darf nicht der Name eines Datasets sein.
Der Ausdruck darf keine Funktionen, ,
Last,PreviousoderRunningValueenthaltenFirst.DasExpression -Objekt darf keine geschachtelten Aggregate enthalten, die ein recursive-Objekt angeben.
Weitere Informationen finden Sie in der Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Sammlungen (Berichts-Generator und SSRS).
Weitere Informationen zu rekursiven Aggregaten finden Sie unter Erstellen rekursiver Hierarchiegruppen (Berichts-Generator und SSRS).
Beispiel
In der folgenden Tabelle werden Beispiele für SqlGeometry-Ausdrücke und Union-Ergebnisausdrücke im WKT-Format (Well Known Text) für räumliche Daten gezeigt.
| Feld mit räumlichen Daten | Beispiel | Union-Ergebnis |
|---|---|---|
| [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")
Weitere Informationen
Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Datentypen in Ausdrücken (Berichts-Generator und SSRS)
Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS)