ST_ToMultiSurface 方法

将几何转换为多表面值。

geometry-expression.ST_ToMultiSurface()

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

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

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

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

SELECT NEW ST_GeomCollection().ST_ToMultiSurface()

以下示例返回结果 [MultiSurface (((3 3, 8 3, 4 8, 3 3)))]。

SELECT Shape.ST_ToMultiSurface()
FROM SpatialShapes WHERE ShapeID = 22

使用DocCommentXchange讨论此页。