STContains（geometry 数据类型）

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库

如果一个 geometry 实例完全包含另一个 geometry 实例，则返回 1。 否则，返回 0。

语法

  
.STContains ( other_geometry )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

参数

other_geometry
将与调用 STContains() 的实例进行比较的另一个 geometry 实例。

返回类型

SQL Server 返回类型：bit

CLR 返回类型：SqlBoolean

注解

如果 geometry 实例的空间引用 ID (SRID) 不匹配，则 STContains() 始终返回 null。

示例

以下示例使用 STContains() 测试两个 geometry 实例，以查看第一个实例是否包含第二个实例。

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POINT(1 1)', 0);  
SELECT @g.STContains(@h);

另请参阅

空间索引概述
几何图形实例上的 OGC 方法