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

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure базе данных SQL в Microsoft Fabric

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

  
.STPointN ( expression )  

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

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

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

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

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

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

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

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

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

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

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