STPointN (geography-Datentyp)
Gibt den angegebenen Punkt in einer geography-Instanz zurück.
Syntax
.STPointN ( expression )
Argumente
- expression
Ein int-Ausdruck zwischen 1 und der Anzahl der Punkte in der geography-Instanz.
Rückgabetypen
SQL Server-Rückgabetyp: geographygeography
CLR-Rückgabetyp: SqlGeographySqlGeography
Open Geospatial Consortium (OGC)-Typ: PointPoint
Hinweise
Wenn eine geography-Instanz von einem Benutzer erstellt wurde, gibt STPointN() den durch expression angegebenen 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 durch expression angegebenen Punkt zurück, indem alle Punkte in der Reihenfolge sortiert werden, in der sie ausgegeben würden: 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 kleineren Wert als 1 aufgerufen wird, löst sie eine ArgumentOutOfRangeException aus.
Wenn diese Methode mit einem Wert aufgerufen wird, der größer ist als die Anzahl der Punkte in der Instanz, 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();