STCurveN (type de données geography)STCurveN (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 la courbe spécifiée à partir d’une instance geography qui est LineString, CircularString ou CompoundCurve.Returns the curve specified from a geography instance that is a LineString, CircularString, or CompoundCurve.

SyntaxeSyntax

  
.STCurveN( n )  

ArgumentsArguments

nn
Expression int comprise entre 1 et le nombre de courbes de l’instance geography.Is an int expression between 1 and the number of curves 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

ExceptionsExceptions

Si n < 1, ArgumentOutOfRangeException est levé.If n < 1 then an ArgumentOutOfRangeException is thrown.

NotesRemarks

NULL est retourné en présence des critères suivants.NULL is returned when the following criteria occurs.

ExemplesExamples

A.A. Utilisation de STCurveN() sur un CircularStringUsing STCurveN() on a CircularString

L’exemple suivant retourne la deuxième courbe d’une instance CircularString :The following example returns the second curve in a CircularString instance:

 DECLARE @g geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';  
 SELECT @g.STCurveN(2).ToString();

L'exemple retourne.The example returns.

CIRCULARSTRING (-122.348 47.658, -122.358 47.658, -122.358 47.653)

B.B. Utilisation de STCurveN() sur un CompoundCurveUsing STCurveN() on a CompoundCurve

L’exemple suivant retourne la deuxième courbe d’une instance CompoundCurve :The following example returns the second curve in a CompoundCurve instance:

 DECLARE @g geography = 'COMPOUNDCURVE(CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))';  
 SELECT @g.STCurveN(2).ToString();

L'exemple retourne.The example returns.

CIRCULARSTRING (-122.348 47.658, -122.358 47.658, -122.358 47.653)

C.C. Utilisation de STCurveN() sur un CompoundCurve qui contient trois CircularStringsUsing STCurveN() on a CompoundCurve Containing Three CircularStrings

L’exemple suivant utilise une instance CompoundCurve qui combine trois instances CircularString distinctes dans la même séquence de courbes que l’exemple précédent :The following example uses a CompoundCurve instance that combines three separate CircularString instances into the same curve sequence as the previous example:

 DECLARE @g geography = 'COMPOUNDCURVE (CIRCULARSTRING (-122.358 47.653, -122.348 47.649, -122.348 47.658), CIRCULARSTRING(-122.348 47.658, -122.358 47.658, -122.358 47.653))';  
 SELECT @g.STCurveN(2).ToString();

L'exemple retourne.The example returns.

CIRCULARSTRING (-122.348 47.658, -122.358 47.658, -122.358 47.653)

STCurveN() retourne les mêmes résultats indépendamment du format de texte WKT utilisé.STCurveN() returns the same results regardless of Well-Known Text (WKT) format that is used.

D.D. Test de validité avant d'appeler STCurve()Testing for Validity Before Calling STCurve()

L’exemple suivant montre comment vérifier que n est valide avant d’appeler la méthode STCurveN() :The following example shows how to make sure that n is valid before you call the STCurveN() method:

 DECLARE @g geography;  
 DECLARE @n int;  
 SET @n = 2;  
 SET @g = geography::Parse('LINESTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)');  
 IF @n >= 1 AND @n <= @g.STNumCurves()  
 BEGIN  
 SELECT @g.STCurveN(@n).ToString();  
 END

Voir aussiSee Also

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