GeometryCollection

A GeometryCollection 是零个或多个geometrygeography实例的集合。 A GeometryCollection 可以为空。

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 ,因为 LinesString 实例中的 GeometryCollection 实例不被接受。

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 无效,因为 Polygon 实例中的 GeometryCollection 实例无效。

有关接受和有效实例的详细信息,请参阅 PointMultiPointLineStringMultiLineStringPolygonMultiPolygon

例子

以下示例实例化一个 geometry``GeometryCollection,在 SRID 1 中包含具有 Z 值的 Point 实例和 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);  

另请参阅

空间数据(SQL Server)