Partilhar via


STPointN (tipo de dados geometry)

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

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

Sintaxe

  
.STPointN ( expression )  

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