Partilhar via


STLineFromText (tipo de dados de geometria)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna uma instância de geometria de uma representação Open Geospatial Consortium (OGC) Well-Known Text (WKT) aumentada com quaisquer valores Z (elevação) e M (medida) transportados pela instância.

Syntax

  
STLineFromText ( 'linestring_tagged_text' , SRID )  

Arguments

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

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

Tipos de devolução

Tipo de retorno do SQL Server: geometria

Tipo de retorno CLR: SqlGeometry

Tipo de OGC: LineString

Remarks

Esse método lança um FormatException se a entrada não estiver bem formatada. Não há suporte para notação WKT de geometria medida e tridimensional do Open Geospatial Consortium (OGC) Simple Features for SQL Specification versão 1.2.1. Veja exemplos para a representação suportada dos valores Z (elevação) e M (medida).

Examples

Os exemplos a seguir são usados STLineFromText() para criar uma geometry instância.

Exemplo 1: Geometria bidimensional WKT

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

Exemplo 2: Geometria tridimensional WKT

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

Exemplo 3: Geometria medida bidimensional WKT

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

Exemplo 4: Geometria medida tridimensional WKT

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

Ver também

Métodos de Geometria Estática OGC