分享方式：

STLength (geometry 資料類型)

  • 文章

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

傳回 geometry 執行個體中元素的總長度。

Syntax

  
.STLength ( )

注意

若要檢視 SQL Server 2014 (12.x) 和更早版本的 Transact-SQL 語法，請參閱舊版文件。

傳回型別

SQL Server 傳回類型：float

CLR 傳回類型：SqlDouble

備註

如果 geometry 執行個體為封閉式，它的長度會計算為此執行個體周圍的總長度；任何多邊形的長度即是其周長，點的長度則為 0。 任何 geometrycollection 類型的長度即是其包含之 geometry 執行個體的長度總和。

STLength() 可在有效與無效的 LineString 上運作。 一般而言，LineString 無效的原因是重疊的線段，而這可能是由不正確的 GPS 追蹤等異常所造成。 STLength() 不會移除重疊或無效的線段。 它會在所傳回的長度值中包含重疊和無效的線段。 MakeValid() 方法可以從 LineString 中移除重疊的線段。

範例

下列範例會建立 LineString 執行個體，並使用 STLength() 來尋找此執行個體的長度。

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);  
SELECT @g.STLength();

另請參閱

幾何例項上的 OGC 方法