Compartilhar via


STPointN (tipo de dados geometry)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

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

Sintaxe

  
.STPointN ( expression )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

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

Tipos de retorno

Tipo de retorno do SQL Server: geometry

Tipo de retorno do CLR: SqlGeometry

Tipo do OGC (Open Geospatial Consortium): Point

Comentários

Se uma instância de geometry for criada pelo usuário, STPointN() retornará o ponto especificado pela expressão ordenando os pontos pela ordem de entrada original.

Se uma instância de geometry for construída pelo sistema, STPointN() retornará o ponto especificado por expressão ordenando os pontos na mesma ordem em que eles seriam emitidos: primeiro pela geometria, depois pelo anel na geometria (se apropriado) e, em seguida, pelo ponto dentro do anel. Essa ordem é determinística.

Se esse método for chamado com um valor menor que 1, ele gerará uma ArgumentOutOfRangeException.

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

Exemplos

O exemplo a seguir cria uma instância LineString e usa STPointN() para recuperar o segundo o 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();  

Consulte Também

Métodos OGC em instâncias geometry