ST_ToMultiPolygon 方法

将几何转换为多面值。

geometry-expression.ST_ToMultiPolygon()

ST_MultiPolygon 如果 geometry-expression 的类型为 ST_MultiPolygon，则返回 geometry-expression。如果 geometry-expression 为仅包含多边形的几何集合，则返回包含 geometry-expression 的元素的多面对象。如果 geometry-expression 的类型为 ST_Polygon，则返回包含一个元素（即 geometry-expression）的多面值。如果 geometry-expression 为空集，则返回类型为 ST_MultiSurface 的空集。否则，将抛出一个异常条件。
结果的空间参照系标识符与 geometry-expression 的空间参照系标识符相同。

如果已知 geometry-expression 为一个 ST_MultiPolygon 值，则使用 TREAT( geometry-expression AS ST_MultiPolygon ) 方法要比使用 ST_ToMultiPolygon 方法更为有效。

缺省情况下，如果几何的原始格式可用，ST_ToMultiPolygon 将使用该格式。否则使用内部格式。有关内部和原始格式的详细信息，请参见STORAGE FORMAT 子句，CREATE SPATIAL REFERENCE SYSTEM 语句。

以下示例返回结果 [MultiPolygon EMPTY]。

SELECT NEW ST_GeomCollection().ST_ToMultiPolygon()

以下示例将返回错误，因为 Shape 列的类型为 ST_Geometry，而 ST_Geometry 不支持 ST_Area 方法。

SELECT Shape.ST_Area()
FROM SpatialShapes WHERE ShapeID = 27

以下示例使用 ST_ToMultiPolygon 将 Shape 列表达式的类型更改为 ST_MultiPolygon。此示例同样适用于 Shape 值类型为 ST_LineString 的 ShapeID 22。ST_Area 返回结果 [8]。

SELECT Shape.ST_ToMultiPolygon().ST_Area()
FROM SpatialShapes WHERE ShapeID = 27

在此情况下，已知 Shape 列值的类型为 ST_MultiPolygon，因此可以使用 TREAT 有效地更改表达式的类型。此示例不适用于 Shape 值类型为 ST_Polygon 的 ShapeID 22。ST_Area 返回结果 [8]。

SELECT TREAT( Shape AS ST_MultiPolygon ).ST_Area() 
FROM SpatialShapes WHERE ShapeID = 27

使用DocCommentXchange讨论此页。