STGeomCollFromText (geometry)

STGeomCollFromText (geometry)#

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.

geometrycollection_tagged_text

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

Return type#

geometry

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.

Example#

Use 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#