STPointN (tipo de datos geometry)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePunto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Devuelve un punto especificado de una instancia de geometry.

Sintaxis

  
.STPointN ( expression )  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

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