STLineFromText (tipo de dados geometry)
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instâ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 )
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();