STPointN (type de données geometry)STPointN (geometry Data Type)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne un point spécifique dans une instance geometry.Returns a specified point in a geometry instance.

SyntaxeSyntax

  
.STPointN ( expression )  

ArgumentsArguments

expressionexpression
Expression int comprise entre 1 et le nombre de points de l’instance geometry.Is an int expression between 1 and the number of points in the geometry instance.

Types de retourReturn Types

Type de retour SQL ServerSQL Server : geometrySQL ServerSQL Server return type: geometry

Type de retour CLR : SqlGeometryCLR return type: SqlGeometry

Type OGC (Open Geospatial Consortium) : PointOpen Geospatial Consortium (OGC) type: Point

NotesRemarks

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.If a geometry instance is user created, STPointN() returns the point specified by expression by ordering the points in the order in which they were originally input.

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.If a geometry instance was constructed by the system, STPointN() returns the point specified by expression by ordering all the points in the same order they would be output: first by geometry, then by ring within the geometry (if appropriate), and then by point within the ring. Cet ordre est déterministe.This order is deterministic.

Si cette méthode est appelée avec une valeur inférieure à 1, elle lève ArgumentOutOfRangeException.If this method is called with a value less than 1, it throws an ArgumentOutOfRangeException.

Si cette méthode est appelée avec une valeur supérieure au nombre de points dans l'instance, elle retourne Null.If this method is called with a value greater than the number of points in the instance, it returns null.

ExemplesExamples

L'exemple suivant crée une instance LineString et utilise STPointN() pour extraire le deuxième point dans la description de l'instance.The following example creates a LineString instance and uses STPointN() to retrieve the second point in the description of the instance.

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

Voir aussiSee Also

Méthodes OGC sur des instances geographyOGC Methods on Geometry Instances