Compartir a través de


STPointN (tipo de datos geometry)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Base de datos de Azure SQL de Microsoft Fabric

Devuelve un punto especificado de una instancia de geometry.

Sintaxis

  
.STPointN ( expression )  

Argumentos

expression
Es una expresión int entre 1 y el número de puntos de la instancia de geometry.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: geometry

Tipo de valor devuelto de CLR: SqlGeometry

Tipo Open Geospatial Consortium (OGC): Point

Comentarios

Si se trata de una instancia de geometry creada por el usuario, STPointN() devuelve el punto especificado por expression considerando los puntos en el orden en el que se especificaron inicialmente.

Si se trata de una instancia de geometry generada por el sistema, STPointN() devuelve el punto especificado por expression considerando todos los puntos en el orden en que se generarían: primero por geometrías, después por anillos dentro de la geometría (si procede) y, luego, por puntos dentro del anillo. Este orden es determinista.

Si se llama a este método con un valor inferior a 1, se genera una excepción ArgumentOutOfRangeException.

Si se llama a este método con un valor superior al número de puntos de la instancia, devuelve NULL.

Ejemplos

En el ejemplo siguiente se crea una instancia de LineString y se usa STPointN() para recuperar el segundo punto de la descripción de la instancia.

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

Consulte también

Métodos de OGC en instancias de geometry