適用於:SQL Server
Azure SQL Database
Azure SQL Managed Instance
Microsoft Fabric 中的 SQL 資料庫
如果 geometry 執行個體與另一個 geometry 執行個體有關 (關聯性是由 Dimensionally Extended 9 Intersection Model (DE-9IM) 模式矩陣值所定義),便傳回 1;否則會傳回 0。
Syntax
.STRelate ( other_geometry, intersection_pattern_matrix )
Arguments
other_geometry
這是要與叫用 所在之執行個體相比較的另一個 STRelate() 執行個體。
intersection_pattern_matrix
這是兩個 geometry 執行個體之間 DE-9IM 模式矩陣裝置的 nchar(9) 類型編碼可接受值字串。
Remarks
如果 geometry 執行個體的空間參考識別碼 (SRID) 不相符,這個方法一律會傳回 Null。 如果矩陣的格式不正確,這個方法將會擲回 ArgumentException。
傳回型別
SQL Server 傳回類型:bit
CLR 傳回類型:SqlBoolean
Examples
下列範例會使用 STRelate(),利用明確的 DE-9IM 模式測試兩個 geometry 執行個體是否在空間上不相鄰。
DECLARE @g geometry;
DECLARE @h geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 2, 2 0, 4 2)', 0);
SET @h = geometry::STGeomFromText('POINT(5 5)', 0);
SELECT @g.STRelate(@h, 'FF*FF****');