STWithin (tipo di dati geometry)

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Endpoint di analisiSQL in Microsoft FabricWarehouse in Microsoft Fabric

Restituisce 1 se un'istanza geometry è completamente all'interno di un'altra istanza geometry. In caso contrario, restituisce 0. Il comando STWithin fa distinzione tra maiuscole e minuscole.

Sintassi

  
.STWithin ( other_geometry )  

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

other_geometry
Altra istanza geometry da confrontare con l'istanza sulla quale viene chiamato STWithin().

Tipi restituiti

Tipo SQL Server restituito: bit

Tipo CLR restituito: SqlBoolean

Osservazioni:

Questo metodo restituisce sempre Null se gli identificatori SRID delle istanze geometry non corrispondono.

Esempi

Nell'esempio seguente viene utilizzato STWithin() per verificare se per due istanze geometry la prima è completamente all'interno della seconda.

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))', 0);  
SELECT @g.STWithin(@h);  

Vedi anche

Panoramica degli indici spaziali
Metodi OGC sulle istanze di geometria