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

Область применения: yesSQL Server (все поддерживаемые версии) YesБаза данных SQL Azure YesУправляемый экземпляр SQL Azure

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

Синтаксис

  
.STPointN ( expression )  

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.

Аргументы

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