Condividi tramite


STLength (tipo di dati geometry)

Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure database SQL in Microsoft Fabric

Restituisce la lunghezza totale degli elementi in un'istanza geometry.

Sintassi

  
.STLength ( )  

Tipi restituiti

Tipo SQL Server restituito: float

Tipo CLR restituito: SqlDouble

Osservazioni:

Se un'istanza geometry è chiusa, la lunghezza viene calcolata come lunghezza totale lungo l'istanza. La lunghezza di qualsiasi poligono è il relativo perimetro e la lunghezza di un punto è 0. La lunghezza di qualsiasi tipo geometrycollection è la somma delle lunghezze delle istanze geometry contenute.

STLength() può essere utilizzato con oggetti LineString validi e non validi. In genere, un oggetto LineString non è valido a causa di segmenti sovrapposti dovuti ad anomalie, ad esempio tracce GPS imprecise. STLength() non rimuove i segmenti sovrapposti o non validi, i quali vengono inclusi nel valore di lunghezza restituito. È possibile rimuovere i segmenti sovrapposti da un oggetto LineString con il metodo MakeValid().

Esempi

Nell'esempio seguente viene creata un'istanza LineString e viene utilizzato STLength() per trovare la lunghezza dell'istanza.

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

Vedi anche

Metodi OGC sulle istanze di geometria