STWithin（geometry 数据类型）

  • 项目

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

如果一个 geometry 实例完全包含在另一个 geometry 实例中，则返回 1；否则，返回 0。 STWithin 命令区分大小写。

语法

  
.STWithin ( other_geometry )

注意

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

参数

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

返回类型

SQL Server 返回类型：bit

CLR 返回类型：SqlBoolean

注解

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

示例

下面的示例使用 STWithin() 来测试两个 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('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))', 0);  
SELECT @g.STWithin(@h);

另请参阅

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