GeometryCollectionは、0 個以上のgeometryまたはgeographyインスタンスのコレクションです。
GeometryCollectionは空にすることができます。
ジオメトリーコレクション (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」を参照してください。
例示
次の例では、Point インスタンスと Polygon インスタンスを含む SRID 1 の Z 値を持つgeometry``GeometryCollectionをインスタンス化します。
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);