CompoundCurve
Si applica a: 
SQL Server Database SQL di Azure Istanza gestita di SQL di Azure
CompoundCurve è una raccolta di zero o più istanze CircularString o LineString continue di tipo 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). Si noti che i valori Z (elevazione) e M (misura) del punto devono essere anch'essi 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. Creazione di un'istanza Geometry con un'istanza CompoundCurve vuota
Nell'esempio seguente viene illustrato come creare un'istanza CompoundCurve vuota:
DECLARE @g geometry;
SET @g = geometry::Parse('COMPOUNDCURVE EMPTY');
B. Dichiarazione e creazione di un'istanza Geometry utilizzando un'istanza 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. Creazione di un'istanza Geography con un'istanza 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. Archiviazione di 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. Creazione di un'istanza Geometry utilizzando un'istanza CompoundCurve con più istanze CircularString
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();
Viene prodotto l'output 12.5663706143592 equivalente a 4?. 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. Utilizzo di un'istanza CompoundCurve per archiviare un semicerchio
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. Archiviazione di più istanze CircularString e LineString in un'istanza 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. Archiviazione di 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. Descrizione del motivo per cui 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 è approssimativamente 4?, che corrisponde al valore effettivo per il perimetro. Il perimetro per Circle One, tuttavia, è significativamente impreciso. L'istanza CompoundCurve di Circle One consente l'archiviazione di un segmento di arco circolare (ABC) e di due segmenti di linea (CD, DA). Tramite l'istanza CompoundCurve devono essere archiviati 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.
Vedi anche
STIsValid (tipo di dati geometry)
STLength (tipo di dati geometry)
STStartPoint (tipo di dati geometry)
STEndpoint (tipo di dati geometry)
LineString
CircularString
Panoramica dei tipi di dati spaziali
Point