STRelate (tipo de datos geometry)

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 la instancia de geometry con la que hay que comparar 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.

Comentarios

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

Tipos de valores devueltos

SQL Server tipo de valor devuelto: 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 usando 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****');

Vea también

Otros recursos

Métodos de OGC en instancias de geometry