STPointN (tipo de dados de geometria)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna um ponto especificado em uma instância de geometria .

Syntax

  
.STPointN ( expression )  

Arguments

expression
É uma expressão int entre 1 e o número de pontos na instância de geometria .

Tipos de devolução

Tipo de retorno do SQL Server: geometria

Tipo de retorno CLR: SqlGeometry

Tipo de Consórcio Geoespacial Aberto (OGC): Ponto

Remarks

Se uma instância de geometria for criada pelo usuário, STPointN() retornará o ponto especificado por expressão ordenando os pontos na ordem em que foram originalmente inseridos.

Se uma instância de geometria foi construída pelo sistema, retorna o ponto especificado por STPointN(), ordenando todos os pontos na mesma ordem em que seriam produzidos: primeiro por geometria, depois por anel dentro da geometria (se apropriado) e, em seguida, por ponto dentro do anel. Esta ordem é determinista.

Se esse método é chamado com um valor menor que 1, ele lança um ArgumentOutOfRangeException.

Se esse método for chamado com um valor maior do que o número de pontos na instância, ele retornará null.

Examples

O exemplo a seguir cria uma LineString instância e usa STPointN() para recuperar o segundo ponto na descrição da instância.

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

Ver também

Métodos OGC em instâncias de geometria