Compartilhar via


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

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