STPointN (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzurePonto de extremidade de análises SQL no Microsoft FabricWarehouse no Microsoft Fabric

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