STWithin (geometry 資料類型)

適用於：Microsoft Fabric 中 Microsoft Fabric倉儲中的 SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體 SQL 分析端點

如果一個 geometry 執行個體完全在另一個 geometry 執行個體內會傳回 1；否則傳回 0。 STWithin 命令會區分大小寫。

Syntax

  
.STWithin ( other_geometry )  

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

other_geometry
這是要與叫用 STWithin() 所在之執行個體相比較的另一個 geometry 執行個體。

傳回型別

SQL Server 傳回類型：bit

CLR 傳回類型：SqlBoolean

備註

如果 geometry 執行個體的空間參考識別碼 (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 方法