STLength (tipo di dati geometry)
Restituisce la lunghezza totale degli elementi in un'istanza geometry.
Sintassi
.STLength ( )
Tipi restituiti
SQL Server tipo 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 geometry collection è 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();