STPointN (type de données geography)
S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance
Retourne le point spécifié dans une instance geography.
Syntaxe
.STPointN ( expression )
Arguments
expression
Expression int comprise entre 1 et le nombre de points de l’instance geography.
Types de retour
Type de retour SQL Server : geography
Type de retour CLR : SqlGeography
Type OGC (Open Geospatial Consortium) : Point
Remarques
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.
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. 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 geography;
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.STPointN(2).ToString();