STUnion (tipo di dati geometry)

Si applica a:SQL ServerAzure SQL DatabaseAzure SQL Istanza gestitaDatabase SQL in Microsoft Fabric

Restituisce un oggetto che rappresenta l'unione di un'istanza geometry con un'altra istanza geometry.

Syntax

  
.STUnion ( other_geometry )  

Arguments

other_geometry
Altra istanza geometry per formare un'unione con l'istanza sulla quale viene chiamato STUnion().

Tipi restituiti

Tipo SQL Server restituito: geometry

Tipo CLR restituito: SqlGeometry

Remarks

Questo metodo restituisce sempre Null se gli identificatori SRID delle istanze geometry non corrispondono. Il risultato può contenere segmenti di arco circolare solo se le istanze di input contengono segmenti di arco circolare.

Examples

A. Calcolo dell'unione di due istanze Polygon

Nell'esempio seguente viene utilizzato STUnion() per calcolare l'unione di due istanze 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. Calcolo dell'unione di un'istanza Polygon e un'istanza CurvePolygon

Nell'esempio seguente viene restituita un'istanza GeometryCollection che contiene un segmento di arco circolare.

 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() restituisce un risultato che contiene un segmento di arco circolare perché l'istanza che ha richiamato STUnion() contiene un segmento di arco circolare.

Vedere anche

Metodi OGC sulle istanze di geometria