Condividi tramite


Collezione di Geometrie

Un GeometryCollection è una raccolta di zero o più istanze di geometry o istanze di geography. Un GeometryCollection oggetto può essere vuoto.

Istanze di GeometryCollection

Istanze accettate

Affinché un'istanza GeometryCollection venga accettata, deve essere un'istanza vuota GeometryCollection o tutte le istanze che comprendono l'istanza GeometryCollection devono essere accettate. L'esempio seguente mostra le istanze accettate.

DECLARE @g1 geometry = 'GEOMETRYCOLLECTION EMPTY';  
DECLARE @g2 geometry = 'GEOMETRYCOLLECTION(LINESTRING EMPTY,POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  
DECLARE @g3 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  

Nell'esempio seguente viene generata un'eccezione System.FormatException perché l'istanza LinesString nell'istanza GeometryCollection non è accettata.

DECLARE @g geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1), POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  

Istanze valide

Un'istanza GeometryCollection è valida quando tutte le istanze che costituiscono l'istanza GeometryCollection sono valide. Di seguito sono illustrate tre istanze valide GeometryCollection e un'istanza non valida.

DECLARE @g1 geometry = 'GEOMETRYCOLLECTION EMPTY';  
DECLARE @g2 geometry = 'GEOMETRYCOLLECTION(LINESTRING EMPTY,POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  
DECLARE @g3 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  
DECLARE @g4 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, 1 -5, -5 5, -5 -1, -1 -1)))';  
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid(), @g4.STIsValid();  

@g4 non è valido perché l'istanza Polygon nell'istanza GeometryCollection non è valida.

Per altre informazioni sulle istanze accettate e valide, vedere Point, MultiPoint, LineString, MultiLineString, Polygon e MultiPolygon.

Esempi

Nell'esempio seguente viene creata un'istanza di geometry``GeometryCollection con valori Z in SRID 1 e contenente un'istanza di Point e un'istanza di Polygon.

DECLARE @g geometry;  
SET @g = geometry::STGeomCollFromText('GEOMETRYCOLLECTION(POINT(3 3 1), POLYGON((0 0 2, 1 10 3, 1 0 4, 0 0 2)))', 1);  

Vedere anche

Dati Spaziali (SQL Server)