STUnion (type de données geometry)
Retourne un objet qui représente l'union d'une instance geometry avec une autre instance geometry.
Syntaxe
.STUnion ( other_geometry )
Arguments
- other_geometry
Autre instance geometry avec laquelle former une union avec l'instance sur laquelle STUnion() est appelé.
Types de retour
SQL Server type de retour : geometry
Type de retour CLR : SqlGeometry
Notes
Cette méthode retourne toujours Null si les ID de référence spatiaux (SRID) des instances geometry ne correspondent pas. Le résultat peut contenir des segments d'arc de cercle uniquement si les instances d'entrée contiennent des segments d'arc de cercle.
Exemples
A.Calcul de l'union de deux instances Polygon
L'exemple suivant utilise STUnion() pour calculer l'union de deux instances Polygon.
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.Calcul de l'union d'une instance Polygon avec une instance CurvePolygon
L'exemple suivant retourne une instance GeometryCollection qui contient un segment d'arc de cercle.
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() retourne un résultat qui contient un segment d'arc de cercle car l'instance qui a appelé STUnion() contient un segment d'arc de cercle.