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