STPointN (type de données geometry)
Retourne un point spécifié dans une instance geometry.
Syntaxe
.STPointN ( expression )
Arguments
- expression
Expression int comprise entre 1 et le nombre de points dans l'instance geometry.
Types des valeurs de retour
SQL Server : geometry
Type de retour CLR : SqlGeometry
Type Open Geospatial Consortium (OGC) : Point
Notes
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 a été construite par le système, STPointN() retourne le point spécifié par expression en classant tous les points dans l'ordre dans lequel ils seraient sortis : d'abord par géométrie, ensuite par anneau dans la géométrie (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 un 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();