STLineFromText (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna uma instância de geometry de uma representação WKT (Well-Known Text) do OGC (Open Geospatial Consortium) aumentada com valores Z (elevação) e M (medida) presentes na instância.

Sintaxe

  
STLineFromText ( 'linestring_tagged_text' , SRID )  

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

linestring_tagged_text
É a representação WKT da instância de geometryLineString que você deseja retornar. linestring_tagged_text é uma expressão nvarchar(max).

SRID
É uma expressão int que representa a SRID (ID de referência espacial) da instância de geometryLineString que você deseja retornar.

Tipos de retorno

Tipo de retorno do SQL Server: geometry

Tipo de retorno do CLR: SqlGeometry

Tipo do OGC: LineString

Comentários

Esse método gerará uma FormatException se a entrada não estiver bem formatada. Não há suporte para a notação de WKT de geometria calculada e de três dimensões dos recursos simples do OGC (Open Geospatial Consortium) para a Especificação do SQL versão 1.2.1. Veja exemplos da representação de valores Z (elevação) e M (medida) com suporte.

Exemplos

O exemplo a seguir usa STLineFromText() para criar uma instância geometry.

Exemplo 1: WKT de geometria bidimensional

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100, 200 200)', 0);  
SELECT @g.ToString();  

Exemplo 2: WKT de geometria tridimensional

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100 100, 200 200 200)', 0);  
SELECT @g.ToString();  

Exemplo 3: WKT de geometria bidimensional calculada

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100 NULL 100, 200 200 NULL 200)', 0);  
SELECT @g.ToString();  

Exemplo 4: WKT de geometria tridimensional calculada

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100 100 100, 200 200 200 200)', 0);  
SELECT @g.ToString();  

Consulte Também

Métodos de geometria estática do OGC