Freigeben über


GeometryCollection

Ein GeometryCollection-Objekt ist eine Auflistung von null oder mehr geometry- oder geography-Instanzen.

GeometryCollection-Instanzen

Akzeptierte Instanzen

Damit eine GeometryCollection-Instanz akzeptiert wird, muss sie entweder eine leere GeometryCollection-Instanz sein, oder alle Instanzen innerhalb der GeometryCollection-Instanz müssen akzeptierte Instanzen sein. Im folgenden Beispiel werden akzeptierte Instanzen veranschaulicht.

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

Das folgende Beispiel löst eine System.FormatException aus, da die LinesString-Instanz in der GeometryCollection-Instanz nicht akzeptiert wird.

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

Gültige Instanzen

Eine GeometryCollection-Instanz ist gültig, wenn alle Instanzen innerhalb der GeometryCollection-Instanz gültig sind. Im Folgenden werden drei gültige GeometryCollection-Instanzen und eine ungültige Instanz dargestellt.

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 ist ungültig, da die Polygon-Instanz in der GeometryCollection-Instanz ungültig ist.

Weitere Informationen zu akzeptierten und gültigen Instanzen finden Sie unter Point, MultiPoint, LineString, MultiLineString, Polygon und MultiPolygon.

Beispiele

Im folgenden Beispiel wird eine geometryGeometryCollection mit Z-Werten im SRID 1 instanziiert, die eine Point-Instanz und eine Polygon-Instanz enthält.

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