Share via

STLineFromText (tipo de datos geometry)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Devuelve una instancia de geometry a partir de una representación Well-Known Text (WKT) de Open Geospatial Consortium (OGC), ampliada con los valores Z (elevación) y M (medida) pertenecientes a la instancia.

Sintaxis

  
STLineFromText ( 'linestring_tagged_text' , SRID )

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

linestring_tagged_text
Es la representación WKT de la instancia de geometryLineString que quiere devolver. linestring_tagged_text es una expresión nvarchar(max).

SRID
Es una expresión de tipo int que representa el identificador de referencia espacial (SRID) de la instancia de geometryLineString que quiere devolver.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: geometry

Tipo de valor devuelto de CLR: SqlGeometry

Tipo OGC: LineString

Observaciones

Este método produce una excepción FormatException si la entrada no tiene el formato correcto. No se admiten las características simples de la notación de WKT de geometría medida y de tres dimensiones de Open Geospatial Consortium (OGC) para la especificación de SQL, versión 1.2.1. Vea los ejemplos de la representación compatible de los valores Z (elevación) y M (medida).

Ejemplos

En los ejemplos siguientes se usa STLineFromText() para crear una instancia de geometry.

Ejemplo 1: WKT de geometría de dos dimensiones

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

Ejemplo 2: WKT de geometría de tres dimensiones

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

Ejemplo 3: WKT de geometría medida de dos dimensiones

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

Ejemplo 4: WKT de geometría medida de tres dimensiones

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

Consulte también

Métodos de geometría estáticos de OGC