STPointN (geography-Datentyp)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Gibt den angegebenen Punkt in einer geography -Instanz zurück.

Syntax

  
.STPointN ( expression )

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

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

Rückgabetypen

SQL Server-Rückgabetyp: geography

CLR-Rückgabetyp: SqlGeography

Open Geospatial Consortium (OGC)-Typ: Point

Bemerkungen

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

Wenn eine geography-Instanz systemseitig erstellt wurde, gibt STPointN() den von expression angegebenen Punkt zurück, indem alle Punkte in der Reihenfolge sortiert werden, in der sie ausgegeben werden: erst nach der geography-Instanz, dann nach dem Ring innerhalb der Instanz (falls zutreffend) und schließlich nach dem 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.

Beispiele

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

DECLARE @g geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STPointN(2).ToString();

Weitere Informationen

OGC-Methoden für geography-Instanzen