Megosztás a következőn keresztül:


GeometryCollection

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseFelügyelt Azure SQL-példánySQL Analytics-végpont a Microsoft FabricbenRaktár a Microsoft FabricbenSQL-adatbázis a Microsoft Fabricben

A GeometryCollection nulla vagy több geometriai vagy földrajzi példány gyűjteménye. A GeometryCollection üres lehet.

GeometryCollection-példányok

Elfogadott esetek

A GeometryCollection-példány elfogadásához üres GeometryCollection-példánynak kell lennie, vagy a GeometryCollection-példányt alkotó összes példányt el kell fogadnia. Az alábbi példák az elfogadott eseteket mutatják be.

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)))';  

Az alábbi példa azért ad egy System.FormatException hibát, mert a GeometryCollection példányban lévő LinesString példány nem fogadható el.

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

Érvényes példányok

A GeometryCollection-példány akkor érvényes, ha a GeometryCollection-példányt alkotó összes példány érvényes. Az alábbiakban három érvényes GeometryCollection-példány és egy érvénytelen példány látható.

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érvénytelen, mert a GeometryCollection-példánypoligonpéldánya érvénytelen.

Az elfogadott és érvényes példányokról további információt a Point, a MultiPoint, a LineString, a MultiLineString, a Polygon és a MultiPolygon című témakörben talál.

Example

Az alábbi példa létrehoz egy geometry és GeometryCollection példányt Z értékekkel az SRID 1-ben, amelyek tartalmaznak egy Point és egy Polygon példányt.

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);