Partager via


STRelate (type de données geometry)

Retourne 1 si une instance geometry est lié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ée.

  • intersection_pattern_matrix
    Chaîne de valeurs de type nchar(9) acceptant l'encodage pour le périphérique de matrice de modèle DE-9IM entre les deux instances geometry.

Notes

Cette méthode retourne toujours Null si les ID de référence spatiaux (SRID) des instances geometry ne correspondent pas. Cette méthode lève un ArgumentException si la matrice n'est pas de forme correcte.

Types des valeurs 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

Autres ressources

Méthodes OGC sur les instances géométriques