Compartilhar via


STRelate (tipo de dados geometry)

Retornará 1 se uma instância geometry tiver relação com outra instância geometry, sendo que a relação é definida por um valor de matriz de padrão DE-9IM (matriz de 9 interseções estendida dimensionalmente); caso contrário, retornará 0.

Sintaxe

.STRelate ( other_geometry, intersection_pattern_matrix )

Argumentos

  • other_geometry
    É outra instância geometry para comparar com a instância na qual STRelate() é invocado.

  • intersection_pattern_matrix
    É uma cadeia de caracteres do tipo nchar(9) que codifica os valores aceitáveis para o dispositivo da matriz de padrão DE-9IM entre as duas instâncias geometry.

Comentários

Esse método sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias geometry não forem correspondentes. Esse método lançará um ArgumentException se a matriz não for bem formada.

Tipos de retorno

Tipo de retorno do SQL Server: bit

Tipo de retorno CLR: SqlBoolean

Exemplos

O exemplo a seguir usa STRelate() para testar duas instâncias geometry para separação espacial usando um padrão 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****');

Consulte também

Outros recursos