InstanceOf (geometry Data Type)

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

A method that tests if the geometry instance is the same as the specified type. Returns 1 if the type of a geometry instance is the same as the specified type, or if the specified type is an ancestor of the instance type; otherwise, returns 0.

|Applies to: SQL Server ( SQL Server 2008 through current version), Azure SQL Database .|


.InstanceOf (geometry_type )  


Is an nvarchar(4000) string specifying one of 15 types exposed in the geometry type hierarchy.

Return Types

SQL Server return type: bit

CLR return type: SqlBoolean


The input for the method must be one of the following: Geometry, Point, Curve, LineString, CircularString, CompoundCurve, Surface, Polygon, CurvePolygon, GeometryCollection, MultiSurface, MultiPolygon, MultiCurve, MultiLineString, and MultiPoint. This method throws an ArgumentException if any other strings are used for the input.


The following example creates a MultiPoint instance and uses InstanceOf() to see if the instance is a GeometryCollection.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('MULTIPOINT(0 0, 13.5 2, 7 19)', 0);  

See Also

Extended Methods on Geometry Instances