STRelate (тип данных geometry)

Область применения: yesSQL Server (все поддерживаемые версии) YesБаза данных SQL Azure YesУправляемый экземпляр SQL Azure

Возвращает значение 1, если экземпляр geometry связан с другим экземпляром geometry, где связь определяется значением шаблона матрицы DE-9IM; в противном случае возвращается 0.

Синтаксис

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.

Аргументы

other_geometry
Другой экземпляр geometry для сравнения с экземпляром, для которого вызван метод STRelate().

intersection_pattern_matrix
Строка типа nchar(9) кодирует приемлемые значения для устройства шаблона матрицы DE-9IM между двумя экземплярами geometry.

Комментарии

Этот метод всегда возвращает значение NULL, если у экземпляров geometry не совпадают идентификаторы пространственных ссылок (SRID). Этот метод вызывает исключение ArgumentException, если формат матрицы неправильный.

Типы возвращаемых данных

Тип возвращаемых данных SQL Server: bit

Тип возвращаемых данных CLR: SqlBoolean

Примеры

В приведенном ниже примере используется STRelate(), чтобы проверить отсутствие пространственного перекрытия двух экземпляров geometry с использованием явного шаблона 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****');  

См. также

Методы OGC в экземплярах Geometry