tostring-geometry-data-type.md

title	description	author	ms.author	ms.date	ms.service	ms.subservice	ms.topic	ms.custom	f1_keywords	helpviewer_keywords	dev_langs
ToString (geometry Data Type)	ToString (geometry Data Type)	MladjoA	mlandzic	08/03/2017	sql	t-sql	reference	ignite-2024	ToString (geometry Data Type)	ToString (geometry Data Type)	TSQL

ToString (geometry Data Type)

[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB]

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

Syntax

  
.ToString ()  

Return Types

[!INCLUDEssNoVersion] return type: nvarchar(max)

CLR return type: SqlString

Remarks

This method will return the string "Null" when called on null instances.

On non-null instances, this method is equivalent to using AsTextZM().

Examples

The following example create a LineString instance and uses ToString() to fetch the text description of the instance.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 0 1, 1 0)', 0);  
SELECT @g.ToString();  

See Also

STAsText (geometry Data Type)
Extended Methods on Geometry Instances