STPointN (tipo de datos geometry)

Devuelve el 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 valores devueltos

Tipo de valor devuelto de SQL Server: geometry

Tipo de valor devuelto de CLR: SqlGeometry

Tipo de Open Geospatial Consortium (OGC): Point

Notas

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, a continuación, 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();

Vea también

Otros recursos