STGeomCollFromText (geometry Data Type)

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Returns a geometry instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation augmented with any Z (elevation) and M (measure) values carried by the instance.

Syntax


STGeomCollFromText ( 'geometrycollection_tagged_text' , SRID )  

Arguments

geometrycollection_tagged_text
Is the WKT representation of the geometry instance you wish to return. geometry_tagged_text is an nvarchar(max) expression.

SRID
Is an int expression representing the spatial reference ID (SRID) of the geometry instance you wish to return.

Return Types

SQL Server return type: geometry

CLR return type: SqlGeometry

Remarks

The OGC type of the geometry instance returned by STGeomCollFromText() is set to the corresponding WKT input.

This method will throw an exception if the input is not valid.

Examples

The following example uses STGeomCollFromText() to create a geometry instance.

DECLARE @g geometry;  
SET @g = geometry::STGeomCollFromText('GEOMETRYCOLLECTION ( POLYGON((5 5, 10 5, 10 10, 5 5)), POINT(10 10) )', 0);  
SELECT @g.ToString();  

See Also

OGC Static Geometry Methods