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.


STGeomCollFromText ( 'geometrycollection_tagged_text' , SRID )  


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

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


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.


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