Colección de Geometrías

GeometryCollection es una colección de cero o más geometry o geography instancias. Un GeometryCollection puede estar vacío.

Instancias de GeometryCollection

Instancias aceptadas

Para que se acepte una GeometryCollection instancia de , debe ser una instancia vacía GeometryCollection o todas las instancias que componen la GeometryCollection instancia deben aceptarse. En el ejemplo siguiente se muestran instancias aceptadas.

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)))';  

En el siguiente ejemplo se lanza una excepción System.FormatException porque la instancia LinesString en la instancia GeometryCollection no se acepta.

DECLARE @g geometry = 'GEOMETRYCOLLECTION(LINESTRING(1 1), POLYGON((-1 -1, -1 -5, -5 -5, -5 -1, -1 -1)))';  

Instancias válidas

Una GeometryCollection instancia es válida cuando todas las instancias que componen la GeometryCollection instancia son válidas. A continuación se muestran tres instancias válidas GeometryCollection y una instancia que no es válida.

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 no es válido porque la Polygon instancia de la GeometryCollection instancia no es válida.

Para obtener más información sobre las instancias aceptadas y válidas, vea Point, MultiPoint, LineString, MultiLineString, Polygon y MultiPolygon.

Ejemplos

En el siguiente ejemplo, se instancia una geometry``GeometryCollection con valores Z en SRID 1 que contiene una instancia de Point y una instancia de Polygon.

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);  

Véase también

Datos Espaciales (SQL Server)