MultiPolygon

适用于:yesSQL Server (所有受支持的版本) Yes Azure SQL 数据库 Yes Azure SQL 托管实例

MultiPolygon 实例是零个或更多个 Polygon 实例的集合。

Polygon 实例

下图显示了 MultiPolygon 实例的示例。

Examples of geometry MultiPolygon instances

如图中所示:

  • 图 1 是一个包含两个 Polygon 元素的 MultiPolygon 实例。 边界由两个外环和三个内环界定。

  • 图 2 是一个包含两个 MultiPolygon 元素的 Polygon 实例。 边界由两个外环和三个内环界定。 这两个 Polygon 元素在切点处相交。

已接受的实例

当满足以下条件之一时,接受 MultiPolygon 实例。

  • 它是空的 MultiPolygon 实例。

  • 组成 MultiPolygon 实例的所有实例是接受的 Polygon 实例。 有关接受的 Polygon 实例的详细信息,请参阅 Polygon

下面的示例显示接受的 MultiPolygon 实例。

DECLARE @g1 geometry = 'MULTIPOLYGON EMPTY';  
DECLARE @g2 geometry = 'MULTIPOLYGON(((1 1, 1 -1, -1 -1, -1 1, 1 1)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  
DECLARE @g3 geometry = 'MULTIPOLYGON(((2 2, 2 -2, -2 -2, -2 2, 2 2)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  

下面的示例显示一个将引发 System.FormatException的 MultiPolygon 实例。

DECLARE @g geometry = 'MULTIPOLYGON(((1 1, 1 -1, -1 -1, -1 1, 1 1)),((1 1, 3 1, 3 3)))';  

MultiPolygon 中的第二个实例是 LineString 实例,而不是接受的 Polygon 实例。

有效实例

如果 MultiPolygon 实例是空的 MultiPolygon 实例或者它满足以下条件,则前者有效。

  1. 组成 MultiPolygon 实例的所有实例是有效的 Polygon 实例。 对于有效的 Polygon 实例,请参阅 Polygon

  2. 组成 Polygon 实例的所有 MultiPolygon 实例都不会重叠。

以下示例显示两个有效的 MultiPolygon 实例和一个无效的 MultiPolygon 实例。

DECLARE @g1 geometry = 'MULTIPOLYGON EMPTY';  
DECLARE @g2 geometry = 'MULTIPOLYGON(((1 1, 1 -1, -1 -1, -1 1, 1 1)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  
DECLARE @g3 geometry = 'MULTIPOLYGON(((2 2, 2 -2, -2 -2, -2 2, 2 2)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid();  

@g2 有效,因为两个 @g2 实例仅在切点处接触。 @g3 无效,因为两个 @g3 实例的内部相互重叠。

示例

示例 A。

下面的示例演示如何创建 geometry``MultiPolygon 实例,并返回第二个组件的熟知文本 (WKT)。

DECLARE @g geometry;  
SET @g = geometry::Parse('MULTIPOLYGON(((0 0, 0 3, 3 3, 3 0, 0 0), (1 1, 1 2, 2 1, 1 1)), ((9 9, 9 10, 10 9, 9 9)))');  
SELECT @g.STGeometryN(2).STAsText();  

示例 B。

该示例实例化一个空的 MultiPolygon 实例。

DECLARE @g geometry;  
SET @g = geometry::Parse('MULTIPOLYGON EMPTY');  

另请参阅

多边形
STArea(geometry 数据类型)
STCentroid(geometry 数据类型)
STPointOnSurface(geometry 数据类型)
空间数据 (SQL Server)