GeometryCollection
GeometryCollection は、0 個以上の geometry インスタンスまたは geography インスタンスのコレクションです。
GeometryCollection インスタンス
許容されるインスタンス
GeometryCollection インスタンスが許容されるには、空の GeometryCollection インスタンスであるか、GeometryCollection インスタンスを構成するすべてのインスタンスが許容されるインスタンスである必要があります。次の例は、許容されるインスタンスを示しています。
DECLARE @g1 geometry = 'GEOMETRYCOLLECTION EMPTY';
DECLARE @g2 geometry = 'GEOMETRYCOLLECTION(LINESTRING EMPTY,POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';
DECLARE @g3 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';
次の例では、GeometryCollection インスタンスの LinesString インスタンスが許容されないため、System.FormatException がスローされます。
DECLARE @g geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1), POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';
有効なインスタンス
GeometryCollection インスタンスが有効であるのは、GeometryCollection インスタンスを構成するすべてのインスタンスが有効である場合です。以下は、3 つの有効な GeometryCollection インスタンスと 1 つの無効なインスタンスを示しています。
DECLARE @g1 geometry = 'GEOMETRYCOLLECTION EMPTY';
DECLARE @g2 geometry = 'GEOMETRYCOLLECTION(LINESTRING EMPTY,POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';
DECLARE @g3 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';
DECLARE @g4 geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1, 3 5),POLYGON((-1 -1, 1 -5, -5 5, -5 -1, -1 -1)))';
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid(), @g4.STIsValid();
@g4 は、GeometryCollection インスタンスの Polygon インスタンスが有効ではないため無効です。
許容されるインスタンスおよび有効なインスタンスの詳細については、「Point」、「MultiPoint」、「LineString」、「MultiLineString」、「Polygon」、および「MultiPolygon」を参照してください。
例
geometryGeometryCollection を、Point インスタンスと Polygon インスタンスを含む SRID 1 の Z 値でインスタンス化する例を次に示します。
DECLARE @g geometry;
SET @g = geometry::STGeomCollFromText('GEOMETRYCOLLECTION(POINT(3 3 1), POLYGON((0 0 2, 1 10 3, 1 0 4, 0 0 2)))', 1);