CompoundCurve
Si applica a: 
SQL Server database SQL di Azure Istanza gestita di SQL di Azure endpoint di analisi SQL in Microsoft Fabric Warehouse nel database SQL di Microsoft Fabric in Microsoft Fabric
CompoundCurve è una raccolta di zero o più istanze CircularString o LineString continue di tipi geometry o geography.
È possibile creare un'istanza CompoundCurve vuota, ma, perché CompoundCurve sia valida, è necessario che vengano rispettati i criteri seguenti:
Deve contenere almeno un'istanza CircularString o LineString .
La sequenza di istanze CircularString o LineString deve essere continua.
Se un'istanza CompoundCurve contiene una sequenza di più istanze CircularString e LineString , l'endpoint finale per ogni istanza, a eccezione dell'ultima, deve essere l'endpoint iniziale dell'istanza successiva nella sequenza. Ciò significa che se il punto finale di un'istanza precedente nella sequenza è (4 3 7 2), il punto iniziale dell'istanza successiva nella sequenza deve essere (4 3 7 2). Anche i valori Z(elevazione) e M(measure) per il punto devono essere uguali. Nel caso di una differenza nei due punti, viene generata un'eccezione System.FormatException . I punti in un'istanza CircularString non devono avere un valore Z o M. Se non sono presenti valori Z o M per il punto finale dell'istanza precedente, il punto iniziale dell'istanza successiva non potrà includere valori Z o M. Se il punto finale della sequenza precedente è (4 3), il punto iniziale della sequenza successiva dovrà essere (4 3). Non potrà essere (4 3 7 2). Tutti i punti in un'istanza CompoundCurve non devono avere alcun valore Z oppure devono avere lo stesso valore Z.
Istanze CompoundCurve
La figura seguente illustra i tipi di CompoundCurve validi.
Istanze accettate
L'istanzaCompoundCurve viene accettata se è un'istanza vuota o se soddisfa i criteri seguenti.
Tutte le istanze contenute nell'istanza CompoundCurve sono istanze di segmenti di arco circolare accettate. Per altre informazioni sulle istanze di segmenti di arco circolare accettate, vedere LineString e CircularString.
Tutti i segmenti di arco circolare nell'istanza CompoundCurve sono connessi. Il primo punto di ogni segmento di arco circolare successivo è uguale all'ultimo punto del segmento di arco circolare precedente.
Nota
Sono incluse le coordinate Z e M. È quindi necessario che tutte e quattro le coordinate X, Y, Z e M siano uguali.
Nessuna delle istanze contenute è un'istanza vuota.
L'esempio seguente illustra le istanze CompoundCurve accettate.
DECLARE @g1 geometry = 'COMPOUNDCURVE EMPTY';
DECLARE @g2 geometry = 'COMPOUNDCURVE(CIRCULARSTRING(1 0, 0 1, -1 0), (-1 0, 2 0))';
L'esempio seguente illustra le istanze CompoundCurve non accettate. Queste istanze generano un'eccezione System.FormatException.
DECLARE @g1 geometry = 'COMPOUNDCURVE(CIRCULARSTRING EMPTY)';
DECLARE @g2 geometry = 'COMPOUNDCURVE(CIRCULARSTRING(1 0, 0 1, -1 0), (1 0, 2 0))';
Istanze valide
Un'istanza CompoundCurve è valida se soddisfa i criteri seguenti.
L'istanza CompoundCurve è stata accettata.
Tutte le istanze di segmenti di arco circolare contenute nell'istanza CompoundCurve sono istanze valide.
L'esempio seguente illustra le istanze CompoundCurve valide.
DECLARE @g1 geometry = 'COMPOUNDCURVE EMPTY';
DECLARE @g2 geometry = 'COMPOUNDCURVE(CIRCULARSTRING(1 0, 0 1, -1 0), (-1 0, 2 0))';
DECLARE @g3 geometry = 'COMPOUNDCURVE(CIRCULARSTRING(1 1, 1 1, 1 1), (1 1, 3 5, 5 4))';
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid();
@g3 è valida perché l'istanza CircularString è valida. Per altre informazioni sulla validità dell'istanza CircularString , vedere CircularString.
L'esempio seguente illustra le istanze CompoundCurve non valide.
DECLARE @g1 geometry = 'COMPOUNDCURVE(CIRCULARSTRING(1 1, 1 1, 1 1), (1 1, 3 5, 5 4, 3 5))';
DECLARE @g2 geometry = 'COMPOUNDCURVE((1 1, 1 1))';
DECLARE @g3 geometry = 'COMPOUNDCURVE(CIRCULARSTRING(1 1, 2 3, 1 1))';
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid();
@g1 non è valida perché la seconda istanza non è un'istanza LineString valida. @g2 non è valida perché l'istanza LineString non è valida. @g3 non è valida perché l'istanza CircularString non è valida. Per altre informazioni sulle istanze CircularString e LineString valide, vedere CircularString e LineString.
Esempi
R. Creare un'istanza geometry con un compooundCurve vuoto
Nell'esempio seguente viene illustrato come creare un'istanza CompoundCurve vuota:
DECLARE @g geometry;
SET @g = geometry::Parse('COMPOUNDCURVE EMPTY');
B. Dichiarare e creare un'istanza geometry usando compoundCurve nella stessa istruzione
L'esempio seguente illustra come dichiarare e inizializzare un'istanza geometry con un'istanza CompoundCurvenella stessa istruzione:
DECLARE @g geometry = 'COMPOUNDCURVE ((2 2, 0 0),CIRCULARSTRING (0 0, 1 2.1082, 3 6.3246, 0 7, -3 6.3246, -1 2.1082, 0 0))';
C. Creare un'istanza geography con CompoundCurve
L'esempio seguente illustra come dichiarare e inizializzare un'istanza geography con un'istanza CompoundCurve:
DECLARE @g geography = 'COMPOUNDCURVE(CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))';
D. Archiviare un quadrato in un'istanza CompoundCurve
Nell'esempio seguente vengono utilizzate due diverse modalità per archiviare un quadrato tramite un'istanza CompoundCurve .
DECLARE @g1 geometry, @g2 geometry;
SET @g1 = geometry::Parse('COMPOUNDCURVE((1 1, 1 3), (1 3, 3 3),(3 3, 3 1), (3 1, 1 1))');
SET @g2 = geometry::Parse('COMPOUNDCURVE((1 1, 1 3, 3 3, 3 1, 1 1))');
SELECT @g1.STLength(), @g2.STLength();
Le lunghezze per @g1 e @g2 sono le stesse. Come illustrato nell'esempio, un'istanza CompoundCurve può archiviare una o più istanze LineString.
E. Creare un'istanza geometry usando CompoundCurve con più CircularStrings
Nell'esempio seguente viene illustrato come utilizzare due diverse istanze CircularString per creare un'istanza CompoundCurve:
DECLARE @g geometry;
SET @g = geometry::Parse('COMPOUNDCURVE(CIRCULARSTRING(0 2, 2 0, 4 2), CIRCULARSTRING(4 2, 2 4, 0 2))');
SELECT @g.STLength();
In questo modo viene generato l'output 12.5663706143592 equivalente a 4pi. L'istanza CompoundCurve riportata nell'esempio consente di archiviare un cerchio con un raggio di 2. In entrambi gli esempi di codice precedenti non è stato necessario utilizzare un'istanza CompoundCurve. Per il primo esempio sarebbe stata più semplice un'istanza LineString , mentre per il secondo esempio sarebbe stata più semplice un'istanza CircularString . Nell'esempio successivo viene tuttavia illustrato in quale punto un'istanza CompoundCurve costituisce una migliore alternativa.
F. Usare compoundCurve per archiviare un semicircolo
Nell'esempio seguente viene utilizzata un'istanza CompoundCurve per archiviare un semicerchio.
DECLARE @g geometry;
SET @g = geometry::Parse('COMPOUNDCURVE(CIRCULARSTRING(0 2, 2 0, 4 2), (4 2, 0 2))');
SELECT @g.STLength();
G. Archiviare più istanze CircularString e LineString in un CompoundCurve
Nell'esempio seguente viene illustrato come è possibile archiviare più istanze CircularString e LineString tramite un'istanza CompoundCurve.
DECLARE @g geometry
SET @g = geometry::Parse('COMPOUNDCURVE((3 5, 3 3), CIRCULARSTRING(3 3, 5 1, 7 3), (7 3, 7 5), CIRCULARSTRING(7 5, 5 7, 3 5))');
SELECT @g.STLength();
H. Archiviare le istanze con valori Z e M
Nell'esempio seguente viene illustrato come utilizzare un'istanza CompoundCurve per archiviare una sequenza di istanze CircularString e LineString con valori Z e M.
SET @g = geometry::Parse('COMPOUNDCURVE(CIRCULARSTRING(7 5 4 2, 5 7 4 2, 3 5 4 2), (3 5 4 2, 8 7 4 2))');
I. Perché le istanze CircularString devono essere dichiarate in modo esplicito
Nell'esempio seguente viene illustrato il motivo per cui è necessario dichiarare in modo esplicito le istanze CircularString . Il programmatore sta tentando di archiviare un cerchio in un'istanza CompoundCurve .
DECLARE @g1 geometry;
DECLARE @g2 geometry;
SET @g1 = geometry::Parse('COMPOUNDCURVE(CIRCULARSTRING(0 2, 2 0, 4 2), (4 2, 2 4, 0 2))');
SELECT 'Circle One', @g1.STLength() AS Perimeter; -- gives an inaccurate amount
SET @g2 = geometry::Parse('COMPOUNDCURVE(CIRCULARSTRING(0 2, 2 0, 4 2), CIRCULARSTRING(4 2, 2 4, 0 2))');
SELECT 'Circle Two', @g2.STLength() AS Perimeter; -- now we get an accurate amount
Il set di risultati è il seguente.
Circle One11.940039...
Circle Two12.566370...
Il perimetro di Circle Two è di circa 4pi, ovvero il valore effettivo per il perimetro. Il perimetro per Circle One, tuttavia, è significativamente impreciso. L'istanza di CompoundCurve Circle One archivia un segmento di arco circolare (ABC) e due segmenti di linea (CD, DA). L'istanza CompoundCurve deve archiviare due segmenti di arco circolare (ABC, CDA) per definire un cerchio. Tramite un'istanza LineString viene definito il secondo set di punti (4 2, 2 4, 0 2) nell'istanza CompoundCurve di Circle One. È necessario dichiarare in modo esplicito un'istanza CircularString in un'istanza CompoundCurve.