Share via


GeometryCollection

GeometryCollection 是零或多個 geometry 或 geography 例項的集合。

GeometryCollection 例項

接受的例項

如果要接受 GeometryCollection 例項,它必須是空的 GeometryCollection 例項,或者包含 GeometryCollection 例項的所有例項都必須是接受的例項。下列範例會顯示接受的例項。

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

下列範例會擲回 System.FormatException,因為 GeometryCollection 例項中的 LinesString 例項不被接受。

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

有效的例項

當包含 GeometryCollection 例項的所有例項都有效時,GeometryCollection 例項就是有效的。下列範例顯示三個有效的 GeometryCollection 例項以及一個無效的例項。

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 無效,因為 GeometryCollection 例項中的 Polygon 例項無效。

如需有關接受及有效例項的詳細資訊,請參閱<Point>、<MultiPoint>、<LineString>、<MultiLineString>、<Polygon>和<MultiPolygon>。

範例

下列範例會具現化 geometryGeometryCollection,其中包含 SRID 1 中具有 Point 例項和 Polygon 例項的 Z 值。

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