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