STRelate (geometria typu danych)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBaza danych SQL w usłudze Microsoft Fabric

Zwraca wartość 1, jeśli wystąpienie geometrii jest powiązane z innym wystąpieniem geometrii , w którym relacja jest definiowana przez wartość macierzy wzorca model de-9IM (Dimensionally Extended 9IM). w przeciwnym razie zwraca wartość 0.

Syntax

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

Arguments

other_geometry
Jest innym wystąpieniem geometrii , które ma być porównywane z wystąpieniem, na którym STRelate() jest wywoływane.

intersection_pattern_matrix
To ciąg typu nchar(9) kodujący dopuszczalne wartości macierzy deseń DE-9IM między dwoma wystąpieniami geometrii .

Remarks

Ta metoda zawsze zwraca wartość null, jeśli identyfikatory odwołań przestrzennych (SRID) wystąpień geometrii nie są zgodne. Ta metoda zgłosi wyjątek ArgumentException , jeśli macierz nie jest poprawnie sformułowana.

Typy zwracane

Zwracany typ programu SQL Server: bit

Typ zwracany clR: SqlBoolean

Examples

W poniższym przykładzie użyto STRelate() metody do testowania dwóch wystąpień geometrii na potrzeby rozłączania przestrzennego przy użyciu jawnego wzorca DE-9IM.

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****');  

Zobacz też

metody OGC w wystąpieniach geometrycznych