STRelate (geometry 資料類型)

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

如果 geometry 執行個體與另一個 geometry 執行個體有關 (關聯性是由 Dimensionally Extended 9 Intersection Model (DE-9IM) 模式矩陣值所定義)，便傳回 1；否則會傳回 0。

Syntax

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

注意

若要檢視 SQL Server 2014 (12.x) 和更早版本的 Transact-SQL 語法，請參閱舊版文件。

引數

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

intersection_pattern_matrix
這是兩個 geometry 執行個體之間 DE-9IM 模式矩陣裝置的 nchar(9) 類型編碼可接受值字串。

備註

如果 geometry 執行個體的空間參考識別碼 (SRID) 不相符，這個方法一律會傳回 Null。 如果矩陣的格式不正確，這個方法將會擲回 ArgumentException。

傳回型別

SQL Server 傳回類型：bit

CLR 傳回類型：SqlBoolean

範例

下列範例會使用 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****');  

另請參閱

幾何例項上的 OGC 方法