STPointN (type de données geography)STPointN (geography 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 le point spécifié dans une instance geography.Returns the specified point in a geography instance.

SyntaxeSyntax

  
.STPointN ( expression )  

ArgumentsArguments

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

Types de retourReturn Types

Type de retour SQL ServerSQL Server : geographySQL ServerSQL Server return type: geography

Type de retour CLR : SqlGeographyCLR return type: SqlGeography

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

Notes Remarks

Si une instance geography 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 geography 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 geography 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 geography, puis par anneau dans l’instance (le cas échéant), puis par point dans l’anneau.If a geography instance is 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 geography instance, then by ring within the instance (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 geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STPointN(2).ToString();  

 Voir aussiSee Also

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