STUnion (geometry-Datentyp)
Gibt ein Objekt zurück, das die Vereinigung einer geometry-Instanz mit einer weiteren geometry-Instanz darstellt.
Syntax
.STUnion ( other_geometry )
Argumente
- other_geometry
Ist eine andere geometry-Instanz, die mit der Instanz zu einer Union vereinigt werden soll, in der STUnion() aufgerufen wird.
Rückgabetypen
SQL Server Rückgabetyp: geometry
CLR-Rückgabetyp: SqlGeometry
Hinweise
Diese Methode gibt immer NULL zurück, wenn die SRIDs (Spatial Reference IDs) der geometry-Instanzen nicht übereinstimmen. Im Ergebnis können nur dann Kreisbogensegmente enthalten sein, wenn die Eingabeinstanzen auch Kreisbogensegmente enthalten.
Beispiele
A.Berechnen der Union von zwei Polygon-Instanzen
Im folgenden Beispiel wird STUnion() zum Berechnen der Vereinigung zweier Polygon-Instanzen verwendet.
DECLARE @g geometry;
DECLARE @h geometry;
SET @g = geometry::STGeomFromText('POLYGON((0 0, 0 2, 2 2, 2 0, 0 0))', 0);
SET @h = geometry::STGeomFromText('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))', 0);
SELECT @g.STUnion(@h).ToString();
B.Berechnen der Union einer Polygon-Instanz und einer CurvePolygon-Instanz
Im folgenden Beispiel wird eine GeometryCollection-Instanz zurückgegeben, die ein Kreisbogensegment enthält.
DECLARE @g geometry = 'CURVEPOLYGON(CIRCULARSTRING(0 -4, 4 0, 0 4, -4 0, 0 -4))';
DECLARE @h geometry = 'POLYGON((5 -1, 5 -3, 7 -3, 7 -1, 5 -1))';
SELECT @g.STUnion(@h).ToString();
STUnion() gibt ein Ergebnis zurück, das ein Kreisbogensegment enthält, da die Instanz, die STUnion() aufgerufen hat, ein Kreisbogensegment enthält.