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