Partage via


STRelate (type de données geometry)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne 1 si une instance geometry est associée à une autre instance geometry, où la relation est définie par une valeur de matrice de modèle DE-9IM (Dimensionally Extended 9 Intersection Model) ; sinon, retourne 0.

Syntaxe

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

Arguments

other_geometry
Autre instance geometry à comparer à l’instance sur laquelle STRelate() est appelé.

intersection_pattern_matrix
Chaîne de type nchar (9) qui code des valeurs acceptables pour l’appareil de matrice de modèle DE-9IM entre les deux instances geometry.

Remarques

Cette méthode retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geometry ne correspondent pas. Cette méthode lève ArgumentException si la matrice n’est pas bien formée.

Types de retour

Type de retour SQL Server : bit

Type de retour CLR : SqlBoolean

Exemples

L’exemple suivant utilise STRelate() pour tester la disjointure spatiale de deux instances geometry à l’aide d’un modèle DE-9IM explicite.

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

Voir aussi

Méthodes OGC sur des instances geography