STPointN (tipo di dati geometry)

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

Restituisce un punto specificato in un'istanza geometry.

Sintassi

  
.STPointN ( expression )  

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

expression
Espressione int compresa tra 1 e il numero di punti nell'istanza geometry.

Tipi restituiti

Tipo SQL Server restituito: geometry

Tipo CLR restituito: SqlGeometry

Tipo OGC (Open Geospatial Consortium): Point

Osservazioni:

Se un'istanza geometry è creata dall'utente, STPointN() restituisce il punto specificato da expression ordinando i punti con l'ordine di immissione originale.

Se un'istanza geometry è stata costruita dal sistema, STPointN() restituisce il punto specificato da expression ordinando tutti i punti nello stesso ordine di restituzione, ovvero prima in base alla geometria, quindi in base all'anello all'interno della geometria (se appropriato), infine in base ai punti all'interno dell'anello. Questo ordine è deterministico.

Se questo metodo viene chiamato con un valore minore di 1, genera un'eccezione ArgumentOutOfRangeException.

Se questo metodo viene chiamato con un valore maggiore del numero di punti nell'istanza, restituisce Null.

Esempi

Nell'esempio seguente viene creata un'istanza LineString e viene utilizzato STPointN() per recuperare il secondo punto della descrizione dell'istanza.

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

Vedi anche

Metodi OGC sulle istanze di geometria