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

  • Статья

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

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

Синтаксис

  
.STPointN ( expression )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

выражение
Выражение типа 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