stdimension-geometry-data-type.md

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

STDimension (geometry Data Type)

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

Returns the maximum dimension of a geometry instance.

Syntax

  
.STDimension ( )  

Return Types

[!INCLUDEssNoVersion] return type: int

CLR return type: SqlInt32

Remarks

STDimension() returns -1 if the geometry instance is empty.

Examples

The following example creates a table variable to hold geometry instances and inserts a Point, a LineString, and a Polygon. It then uses STDimension() to return the dimensions of each geometry instance.

DECLARE @temp table ([name] varchar(10), [geom] geometry);  
INSERT INTO @temp values ('Point', geometry::STGeomFromText('POINT(3 3)', 0));  
INSERT INTO @temp values ('LineString', geometry::STGeomFromText('LINESTRING(0 0, 3 3)', 0));  
INSERT INTO @temp values ('Polygon', geometry::STGeomFromText('POLYGON((0 0, 3 0, 0 3, 0 0))', 0));  
SELECT [name], [geom].STDimension() as [dim]  
FROM @temp;  

The example then returns the dimensions of each geometry instance.

name	dim
Point	0
LineString	1
Polygon	2

See Also

OGC Methods on Geometry Instances