STArea（geometry 数据类型）

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库

返回 geometry 实例的总表面积。

语法

  
.STArea ( )  

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

返回类型

SQL Server 返回类型：float

CLR 返回类型：SqlDouble

注解

如果 geometry 实例仅包含 0 维和 1 维图形，或者为空，则 STArea() 返回 0。 如果 geometry 实例尚未初始化，则 STArea() 返回 NULL。

示例

A. 计算 Polygon 实例的面积

以下示例创建一个 Polygon``geometry 实例并计算多边形的面积。

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0),(2 2, 2 1, 1 1, 1 2, 2 2))', 0);  
SELECT @g.STArea();  

B. 计算 CurvePolygon 实例的面积

以下示例计算 CurvePolygon 实例的面积。

 DECLARE @g geometry;  
 SET @g = geometry::Parse('CURVEPOLYGON(CIRCULARSTRING(0 2, 2 0, 4 2, 4 2, 0 2))');  
 SELECT @g.STArea() AS Area;

另请参阅

几何图形实例上的 OGC 方法