Поделиться через


STPointN (тип данных geometry)

Применимо к:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureБаза данных SQL в Microsoft Fabric

Возвращает конкретную точку в экземпляре geometry.

Syntax

  
.STPointN ( expression )  

Arguments

expression
Выражение типа int от 1 до количества точек в экземпляре geometry.

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

Тип возвращаемых данных SQL Server: geometry

Тип возвращаемых данных CLR: SqlGeometry

Тип открытого геопространственного консорциума (OGC): Point

Remarks

Если экземпляр geometry создан пользователем, то метод STPointN() возвращает точку, указанную в expression путем размещения точек в порядке, в котором они были первоначально введены.

Если экземпляр geometry был создан системой, то метод STPointN() возвращает точку, определяемую выражением expression путем размещения всех точек в том же порядке, в котором они будут выведены: сначала по геометрическим объектам, затем по кольцам внутри геометрического объекта (если применимо), а затем по точкам внутри кольца. Это порядок является детерминированным.

Если этот метод вызывается со значением менее 1, то будет вызвано исключение ArgumentOutOfRangeException.

Если этот метод вызывается со значением, превышающим число точек в экземпляре, он возвращает значение NULL.

Examples

В следующем примере создается экземпляр LineString, и при помощи метода STPointN() производится получение второй точки в его описании.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);  
SELECT @g.STPointN(2).ToString();  

См. также

Методы OGC в экземплярах Geometry