Share via

STLineFromText (geometry-Datentyp)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Gibt eine geometry -Instanz aus einer Darstellung des Typs Open Geospatial Consortium (OGC) Well-Known Text (WKT) zurück, die um alle von der Instanz getragenen Z (Höhe)- und M (Measure)-Werte erweitert wurde.

Syntax

  
STLineFromText ( 'linestring_tagged_text' , SRID )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

linestring_tagged_text
Die WKT-Darstellung der geometryLineString-Instanz, die Sie zurückgegeben möchten. linestring_tagged_text ist ein nvarchar(max)-Ausdruck.

SRID
Ein int-Ausdruck, der die SRID (Spatial Reference ID) der geometryLineString-Instanz darstellt, die Sie zurückgeben möchten.

Rückgabetypen

SQL Server-Rückgabetyp: geometry

CLR-Rückgabetyp: SqlGeometry

OGC-Typ: LineString

Bemerkungen

Diese Methode löst eine FormatException aus, wenn die Eingabe nicht ordnungsgemäß formatiert ist. Die WKT-Notation für dreidimensionale und gemessene Geometrie in Open Geospatial Consortium (OGC) Simple Features for SQL Specification Version 1.2.1 wird nicht unterstützt. Siehe Beispiele der unterstützten Darstellung der Werte Z (Höhe) und M (Measure).

Beispiele

In den folgenden Beispielen wird STLineFromText() verwendet, um eine geometry-Instanz zu erstellen.

Beispiel 1: WKT mit zweidimensionaler Geometrie

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

Beispiel 2: WKT mit dreidimensionaler Geometrie

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

Beispiel 3: WKT mit zweidimensional gemessener Geometrie

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

Beispiel 4: WKT mit dreidimensional gemessener Geometrie

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

Weitere Informationen

Statische geometry-Methoden des OGC