Freigeben über


STPointN (geometry-Datentyp)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzSQL-Datenbank in Microsoft Fabric

Gibt einen festgelegten Punkt in einer geometry -Instanz zurück.

Syntax

  
.STPointN ( expression )  

Arguments

expression
Ein int -Ausdruck zwischen 1 und der Anzahl der Punkte in der geometry -Instanz.

Rückgabetypen

SQL Server-Rückgabetyp: geometry

CLR-Rückgabetyp: SqlGeometry

Open Geospatial Consortium (OGC)-Typ: Point

Remarks

Wenn eine geometry -Instanz von einem Benutzer erstellt wurde, gibt STPointN() den durch expression festgelegten Punkt zurück, indem die Punkte in der Reihenfolge sortiert werden, in der sie ursprünglich eingegeben wurden.

Wenn eine geometry -Instanz systemseitig konstruiert wurde, gibt STPointN() den durch expression festgelegten Punkt zurück, indem alle Punkte in der Reihenfolge sortiert werden, in der sie ausgegeben würden: erst nach Geometrie, dann nach Ring innerhalb der Geometrie (falls zutreffend) und schließlich nach Punkt innerhalb des Rings. Diese Reihenfolge ist deterministisch.

Wenn diese Methode mit einem geringeren Wert als 1 aufgerufen wird, löst sie eine ArgumentOutOfRangeExceptionaus.

Wenn diese Methode mit einem Wert aufgerufen wird, der die Anzahl der Punkte in der Instanz übersteigt, gibt sie NULL zurück.

Examples

Im folgenden Beispiel wird eine LineString -Instanz erstellt und STPointN() verwendet, um den zweiten Punkt in der Beschreibung der Instanz abzurufen.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);  
SELECT @g.STPointN(2).ToString();  

Siehe auch

OGC-Methoden für geometry-Instanzen