STWithin (geometry-Datentyp)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceSQL Analytics-Endpunkt in Microsoft FabricWarehouse in Microsoft Fabric

Gibt 1 zurück, wenn eine geometry -Instanz sich vollständig innerhalb einer anderen geometry -Instanz befindet. Andernfalls wird 0 zurückgegeben. Für den Befehl STWithin muss die Groß-/Kleinschreibung beachtet werden.

Syntax

  
.STWithin ( other_geometry )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

other_geometry
Eine andere geometry -Instanz zum Vergleich mit der Instanz, in der STWithin() aufgerufen wird.

Rückgabetypen

SQL Server-Rückgabetyp: bit

CLR-Rückgabetyp: SqlBoolean

Hinweise

Diese Methode gibt immer NULL zurück, wenn die SRIDs (Spatial Reference IDs) der geometry -Instanzen nicht übereinstimmen.

Beispiele

Im folgenden Beispiel wird STWithin() verwendet, um zwei geometry -Instanzen daraufhin zu überprüfen, ob die erste Instanz sich vollständig innerhalb der zweiten Instanz befindet.

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

Weitere Informationen

Übersicht über räumliche Indizes
OGC-Methoden für geometry-Instanzen