STRelate (tipo de datos geometry)
Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance
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.
Sintaxis
.STRelate ( other_geometry, intersection_pattern_matrix )
Argumentos
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.
Observaciones
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
Ejemplos
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****');