STLineFromText (type de données geometry)

S’applique à : SQL ServerAzure SQL Database Azure SQL Managed Instance

Retourne une instance geometry à partir d’une représentation OGC (Open Geospatial Consortium) WKT (Well-Known Text), à laquelle s’ajoutent les valeurs Z (élévation) et M (mesure) apportées par l’instance.

Syntaxe

  
STLineFromText ( 'linestring_tagged_text' , SRID )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

linestring_tagged_text
Représentation WKT de l’instance geometryLineString à retourner. linestring_tagged_text est une expression nvarchar(max).

SRID
Expression int qui représente le SRID (spatial reference identifier ) de l’instance geometryLineString à retourner.

Types de retour

Type de retour SQL Server : geometry

Type de retour CLR : SqlGeometry

Type OGC : LineString

Notes

Cette méthode lève FormatException si l’entrée n’est pas au format approprié. La notation de géométrie WKT à trois dimensions et mesurée à partir de la fonctionnalité simple Open Geospatial Consortium (OGC) pour la version de spécification SQL version 1.2.1 n’est pas prise en charge. Consultez les exemples pour la représentation prise en charge des valeurs Z (élévation) et M (mesure).

Exemples

Les exemples suivants utilisent la méthode STLineFromText() pour créer une instance geometry.

Exemple 1 : géométrie WKT à deux dimensions

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

Exemple 2 : géométrie WKT à trois dimensions

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

Exemple 3 : géométrie mesurée WKT à deux dimensions

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

Exemple 4 : géométrie mesurée WKT à trois dimensions

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

Voir aussi

Méthodes géométriques statiques OGC