MultiLineString
適用対象: 
SQL Server Azure SQL Database Azure SQL Managed Instance Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス Microsoft Fabric のSQL データベース
MultiLineString は、0 個以上の geometry または geographyLineString インスタンスのコレクションです。
MultiLineString インスタンス
次の図は、 MultiLineString インスタンスの例を示しています。
この図は次のことを示しています。
図 1 は、2 つの LineString 要素の 4 つの終点からなる境界を持つ単純な MultiLineString インスタンスです。
図 2 の MultiLineString インスタンスは、 LineString 要素の終点のみで交差しているため単純です。 境界は、重複しない 2 つのエンドポイントです。
図 3 の MultiLineString インスタンスは、 LineString 要素の内部で交差しているため単純ではありません。 この MultiLineString インスタンスの境界は 4 つの終点です。
図 4 は、単純でなく、閉じていない MultiLineString インスタンスです。
図 5 は、単純な、閉じていない MultiLineStringです。 このインスタンスが閉じていないのは、その LineStrings 要素が閉じていないからです。 このインスタンスが単純なのは、内部で交差している LineStrings インスタンスがないからです。
図 6 は、単純な閉じている MultiLineString インスタンスです。 このインスタンスが閉じているのは、そのすべての要素が閉じているからです。 このインスタンスが単純なのは、内部で交差している要素がないからです。
許容されるインスタンス
MultiLineString インスタンスを受け入れるには、空であるか、受け入れられるLineString インスタンスのみで構成されている必要があります。 許容される LineString インスタンスの詳細については、「 LineString」を参照してください。 次の例に、許容される MultiLineString インスタンスを示します。
DECLARE @g1 geometry = 'MULTILINESTRING EMPTY';
DECLARE @g2 geometry = 'MULTILINESTRING((1 1, 3 5), (-5 3, -8 -2))';
DECLARE @g3 geometry = 'MULTILINESTRING((1 1, 5 5), (1 3, 3 1))';
DECLARE @g4 geometry = 'MULTILINESTRING((1 1, 3 3, 5 5),(3 3, 5 5, 7 7))';
次の例では、2 番目の System.FormatException LineString インスタンスが有効ではないため、 がスローされます。
DECLARE @g geometry = 'MULTILINESTRING((1 1, 3 5),(-5 3))';
有効なインスタンス
MultiLineString インスタンスを有効にするには、次の条件を満たす必要があります。
MultiLineString インスタンスを構成するすべてのインスタンスが、有効な LineString インスタンスでなければならない。
MultiLineString インスタンスを構成する 2 つの LineString インスタンスは、1 つの間隔で重複することはできません。 LineString インスタンスは、有限数の接点のみで、互いにまたは他の LineString インスタンスと交差するか接することができます。
次の例に、3 つの有効な MultiLineString インスタンスと 1 つの無効な MultiLineString インスタンスを示します。
DECLARE @g1 geometry = 'MULTILINESTRING EMPTY';
DECLARE @g2 geometry = 'MULTILINESTRING((1 1, 3 5), (-5 3, -8 -2))';
DECLARE @g3 geometry = 'MULTILINESTRING((1 1, 5 5), (1 3, 3 1))';
DECLARE @g4 geometry = 'MULTILINESTRING((1 1, 3 3, 5 5),(3 3, 5 5, 7 7))';
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid(), @g4.STIsValid();
@g4 は、2 番目の LineString インスタンスが最初の LineString インスタンスと内部で重なっているため、有効ではありません。 有限数の接点で接しています。
例
次の例では、2 つの geometry``MultiLineString 要素を含む SRID 0 の単純な LineString インスタンスを作成しています。
DECLARE @g geometry;
SET @g = geometry::Parse('MULTILINESTRING((0 2, 1 1), (1 0, 1 1))');
このインスタンスを別の SRID で作成するには、 STGeomFromText() または STMLineStringFromText()を使用します。 次の例のように、 Parse() を使用して、その後に SRID を変更することもできます。
DECLARE @g geometry;
SET @g = geometry::Parse('MULTILINESTRING((0 2, 1 1), (1 0, 1 1))');
SET @g.STSrid = 13;