STCurveN (тип данных geography)STCurveN (geography Data Type)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server даБаза данных SQL AzureнетХранилище данных SQL AzureнетParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Возвращает кривую, указанную в экземпляре geography типа LineString, CircularString или CompoundCurve.Returns the curve specified from a geography instance that is a LineString, CircularString, or CompoundCurve.

СинтаксисSyntax

  
.STCurveN( n )  

АргументыArguments

nn
Выражение типа int со значением в диапазоне от 1 до числа кривых в экземпляре geography.Is an int expression between 1 and the number of curves in the geography instance.

Типы возвращаемых данныхReturn Types

Тип возвращаемых данных SQL ServerSQL Server: geographySQL ServerSQL Server return type: geography

Тип возвращаемого значения CLR: SqlGeographyCLR return type: SqlGeography

ИсключенияExceptions

Если n < 1, возникает исключение ArgumentOutOfRangeException.If n < 1 then an ArgumentOutOfRangeException is thrown.

RemarksRemarks

Значение NULL возвращается при возникновении указанных ниже условий.NULL is returned when the following criteria occurs.

ПримерыExamples

A.A. Применение метода STCurveN() к объекту CircularStringUsing STCurveN() on a CircularString

В приведенном ниже примере возвращается вторая кривая в экземпляре 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();

Пример возвращает управление.The example returns.

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

Б.B. Применение метода STCurveN() к объекту CompoundCurveUsing STCurveN() on a CompoundCurve

В приведенном ниже примере возвращается вторая кривая в экземпляре 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();

Пример возвращает управление.The example returns.

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

В.C. Применение метода STCurveN() к объекту CompoundCurve, содержащему три объекта CircularStringUsing STCurveN() on a CompoundCurve Containing Three CircularStrings

В приведенном ниже примере используется экземпляр CompoundCurve, в котором три отдельных экземпляра CircularString объединяются в одной последовательности кривых, как в предыдущем примере.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();

Пример возвращает управление.The example returns.

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

STCurveN() возвращает одинаковые результаты независимо от используемого формата Well-Known Text (WKT).STCurveN() returns the same results regardless of Well-Known Text (WKT) format that is used.

Г.D. Проверка допустимости перед вызовом метода STCurve()Testing for Validity Before Calling STCurve()

В приведенном ниже примере показано, как проверить допустимость n перед вызовом метода 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

См. также:See Also

Методы OGC в экземплярах GeographyOGC Methods on Geography Instances