STLength (geometry-Datentyp)
Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance SQL-Datenbank in Microsoft Fabric
Gibt die Gesamtlänge der Elemente in einer geometry-Instanz zurück.
Syntax
.STLength ( )
Rückgabetypen
SQL Server-Rückgabetyp: float
CLR-Rückgabetyp: SqlDouble
Hinweise
Wenn eine geometry-Instanz geschlossen ist, wird ihre Länge als Gesamtlänge um die Instanz herum berechnet. Die Länge eines Polygons entspricht seinem Umfang, und die Länge eines Punkts ist 0. Die Länge eines beliebigen geometrycollection-Typs ist die Summe der Längen der in ihm enthaltenen geometry-Instanzen.
STLength() funktioniert sowohl für gültige als auch für ungültige LineStrings. In der Regel ist ein LineString aufgrund überlappender Segmente ungültig, die möglicherweise durch Anomalien wie ungenaue GPS-Ablaufverfolgungen verursacht werden. STLength() entfernt keine überlappenden oder ungültigen Segmente. Sie schließt überlappende und ungültige Segmente in den zurückgegebenen Längenwert ein. Die MakeValid()-Methode kann überlappende Segmente aus einem LineString entfernen.
Beispiele
Im folgenden Beispiel wird eine LineString
-Instanz erstellt und STLength()
verwendet, um die Länge der Instanz zu bestimmen.
DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);
SELECT @g.STLength();