MultiLineString
Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечную точку аналитики SQL в хранилище Microsoft Fabric в базе данных SQL Microsoft Fabric в Microsoft Fabric
Тип данных MultiLineString представляет собой коллекцию экземпляров geometry или geographyLineString .
Экземпляры MultiLineString
На следующем рисунке показаны примеры экземпляров MultiLineString .
На рисунке представлены:
Изображение 1 представляет простой экземпляр MultiLineString , граница которого определяется четырьмя конечными точками двух его элементов LineString .
Изображение 2 представляет простой экземпляр MultiLineString , поскольку пересекаются только конечные точки элементов LineString . Граница — это две неперекрывающиеся конечные точки.
Изображение 3 представляет непростой экземпляр MultiLineString , поскольку имеется пересечение внутренней части одного из элементов LineString этого экземпляра. Границей данного экземпляра MultiLineString являются четыре конечные точки.
На рисунке 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))';
Приведенный ниже пример вызывает исключение System.FormatException
, так как второй экземпляр LineString недействителен.
DECLARE @g geometry = 'MULTILINESTRING((1 1, 3 5),(-5 3))';
Допустимые экземпляры
Для допустимого экземпляра MultiLineString он должен соответствовать следующим критериям:
Все экземпляры, составляющие экземпляр MultiLineString , должны быть действительными экземплярами LineString .
Ни два экземпляра LineString , состоящие из экземпляра MultiLineString , не могут перекрываться через интервал. Экземпляры LineString могут взаимодействовать или соприкасаться только с собой или с другими экземплярами LineString в конечном числе точек.
В следующем примере показаны три действительных экземпляра MultiLineString и один экземпляр 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
является недопустимым, так как второй экземпляр LineString пересекается с первым экземпляром LineString в интервале. Они соприкасаются в бесконечном количестве точек.
Примеры
В следующем примере создается простой экземпляр geometry``MultiLineString
, содержащий два элемента LineString
со значением SRID 0.
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;