GeometryCollection

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceTitik akhir analitik SQL di Microsoft FabricGudang di Microsoft FabricDatabase SQL di Microsoft Fabric

GeometryCollection adalah kumpulan nol atau lebih geometri atau instans geografi. GeometryCollection dapat kosong.

Instans GeometryCollection

Instans yang diterima

Agar instans GeometryCollection diterima, instans tersebut harus berupa instans GeometryCollection kosong atau semua instans yang terdiri dari instans GeometryCollection harus diterima instans. Contoh berikut menunjukkan instans yang diterima.

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

Contoh berikut melemparkan System.FormatException karena instans LinesString dalam instans GeometryCollection tidak diterima.

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

Instans yang valid

Instans GeometryCollection valid ketika semua instans yang terdiri dari instans GeometryCollection valid. Berikut ini menunjukkan tiga instans GeometryCollection yang valid dan satu instans yang tidak valid.

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 tidak valid karena instans Poligon dalam instans GeometryCollection tidak valid.

Untuk informasi selengkapnya tentang instans yang diterima dan valid, lihat Point, MultiPoint, LineString, MultiLineString, Polygon, dan MultiPolygon.

Example

Contoh berikut membuat instans geometryGeometryCollection dengan nilai Z di SRID 1 yang Point berisi instans dan Polygon instans.

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

Konten terkait

• Data Spasial