STPointN (geometria typu danych)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBaza danych SQL w usłudze Microsoft Fabric

Zwraca określony punkt w wystąpieniu geometrii .

Syntax

  
.STPointN ( expression )  

Arguments

expression
Jest wyrażeniem int z zakresu od 1 do liczby punktów w wystąpieniu geometrii .

Typy zwracane

Zwracany typ programu SQL Server: geometria

Typ zwracania CLR: SqlGeometry

Typ open Geospatial Consortium (OGC): Punkt

Remarks

Jeśli wystąpienie geometrii jest tworzone przez użytkownika, STPointN() zwraca punkt określony przez wyrażenie , porządkując punkty w kolejności, w której pierwotnie zostały wprowadzone.

Jeśli wystąpienie geometrii zostało skonstruowane przez system, STPointN() zwraca punkt określony przez wyrażenie , porządkując wszystkie punkty w tej samej kolejności, które byłyby wynikiem: najpierw przez geometrię, a następnie przez pierścień w geometrii (jeśli jest to konieczne), a następnie przez punkt w pierścieniu. Ta kolejność jest deterministyczna.

Jeśli ta metoda jest wywoływana z wartością mniejszą niż 1, zgłasza wyjątek ArgumentOutOfRangeException.

Jeśli ta metoda jest wywoływana z wartością większą niż liczba punktów w wystąpieniu, zwraca wartość null.

Examples

Poniższy przykład tworzy LineString wystąpienie i używa STPointN() go do pobrania drugiego punktu w opisie wystąpienia.

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

Zobacz też

metody OGC w wystąpieniach geometrycznych