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 实例无效。

有关接受且有效的实例的详细信息,请参阅 PointMultiPointLineStringMultiLineString多边形MultiPolygon

示例

下面的示例实例化一个包含 Point 实例和 Polygon 实例的 geometryGeometryCollection,它具有 Z 值,且 SRID 为 1。

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