STRelate (tipo de datos geometry)

Se aplica a:SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLBase de datos SQL en Microsoft Fabric

Devuelve 1 si una instancia de geometry está relacionada con otra instancia de geometry, donde la relación está definida por un valor de matriz de patrones DE-9IM (Dimensionally Extended 9 Intersection Model); en caso contrario, devuelve 0.

Syntax

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

Arguments

other_geometry
Es otra instancia de geometry con la que se compara la instancia en la que se invoca STRelate().

intersection_pattern_matrix
Es una cadena de tipo nchar(9) que codifica valores aceptables para el dispositivo de matriz de patrones DE-9IM entre las dos instancias de geometry.

Remarks

Este método siempre devuelve NULL si no coinciden los identificadores de referencia espacial (SRID) de las instancias de geometry. Este método produce una excepción ArgumentException si la matriz no tiene el formato correcto.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: bit

Tipo de valor devuelto de CLR: SqlBoolean

Examples

En el ejemplo siguiente se usa STRelate() para comprobar si dos instancias de geometry no están combinadas en el espacio mediante un patrón DE-9IM explícito.

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

Véase también

Métodos de OGC en instancias de geometry