STPointN (geometry データ型)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

geometry インスタンス内の指定した地点を返します。

構文

  
.STPointN ( expression )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

式 (expression)
1 から geometry インスタンス内の地点の数までの int 式です。

戻り値の型

SQL Server の戻り値の型: geometry

CLR 戻り値の型: SqlGeometry

Open Geospatial Consortium (OGC) の型: Point

解説

ユーザーが作成した geometry インスタンスの場合、STPointN() は、最初に入力した順序で地点を並べ替えることで、expression で指定された地点を返します。

システムによって作成された geometry インスタンスの場合、STPointN() は、出力する順序ですべての地点を並べ替えることで、expression で指定された地点を返します。出力する順序にするには、geometry、geometry 内のリング (必要な場合)、リング内の地点の順序に並べ替えます。 この順序は決定的です。

1 未満の値を指定してこのメソッドを呼び出すと、ArgumentOutOfRangeException がスローされます。

インスタンス内の地点の数より大きい値を指定してこのメソッドを呼び出すと、メソッドは NULL を返します。

例

LineString インスタンスを作成し、STPointN() を使用して、このインスタンスの記述に含まれる 2 番目の地点を取得する例を次に示します。

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

参照

Geometry インスタンスの OGC メソッド