STArea (geometry 資料類型)

適用於：sql Server Azure SQL 資料庫 Azure SQL 受控執行個體 Microsoft Fabric Microsoft Fabric 倉儲中的 SQL 分析端點

傳回 geometry 執行個體的總介面區。

Syntax

  
.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 方法