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();