STPointN (type de données geometry)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePoint de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Retourne un point spécifique dans une instance geometry.

Syntaxe

  
.STPointN ( expression )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

expression
Expression int comprise entre 1 et le nombre de points de l’instance geometry.

Types de retour

Type de retour SQL Server : geometry

Type de retour CLR : SqlGeometry

Type OGC (Open Geospatial Consortium) : Point

Remarques

Si une instance geometry est créée par l’utilisateur, STPointN() retourne le point spécifié par expression en classant les points dans l’ordre dans lequel ils ont été entrés à l’origine.

Si une instance geometry est construite par le système, STPointN() retourne le point spécifié par expression en classant tous les points dans le même ordre que celui de leur sortie : d’abord par instance geometry, puis par anneau dans l’instance geometry (le cas échéant), puis par point dans l’anneau. Cet ordre est déterministe.

Si cette méthode est appelée avec une valeur inférieure à 1, elle lève ArgumentOutOfRangeException.

Si cette méthode est appelée avec une valeur supérieure au nombre de points dans l'instance, elle retourne Null.

Exemples

L'exemple suivant crée une instance LineString et utilise STPointN() pour extraire le deuxième point dans la description de l'instance.

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

Voir aussi

Méthodes OGC sur des instances geography