Класс SqlGeometry

 

Тип SqlGeometry представляет данные в Евклидовой (плоской) системе координат.

Пространство имен:   Microsoft.SqlServer.Types
Сборка:  Microsoft.SqlServer.Types (в Microsoft.SqlServer.Types.dll)

Иерархия наследования

System.Object
  Microsoft.SqlServer.Types.SqlGeometry

Синтаксис

[SerializableAttribute]
[SqlUserDefinedTypeAttribute(Format.UserDefined, IsByteOrdered = false, 
    MaxByteSize = -1, IsFixedLength = false)]
[CLSCompliantAttribute(true)]
public sealed class SqlGeometry : INullable, IBinarySerialize, 
    ISqlSpatialGridIndexable

[SerializableAttribute]
[SqlUserDefinedTypeAttribute(Format::UserDefined, IsByteOrdered = false, 
    MaxByteSize = -1, IsFixedLength = false)]
[CLSCompliantAttribute(true)]
public ref class SqlGeometry sealed : INullable, IBinarySerialize, 
    ISqlSpatialGridIndexable

[<Sealed>]
[<SerializableAttribute>]
[<SqlUserDefinedTypeAttribute(Format.UserDefined, IsByteOrdered = false,
    MaxByteSize = -1, IsFixedLength = false)>]
[<CLSCompliantAttribute(true)>]
type SqlGeometry = 
    class
        interface INullable
        interface IBinarySerialize
        interface ISqlSpatialGridIndexable
    end

<SerializableAttribute>
<SqlUserDefinedTypeAttribute(Format.UserDefined, IsByteOrdered := False,
    MaxByteSize := -1, IsFixedLength := False)>
<CLSCompliantAttribute(True)>
Public NotInheritable Class SqlGeometry
    Implements INullable, IBinarySerialize, ISqlSpatialGridIndexable

Конструкторы

	Имя	Описание
	SqlGeometry()	Инициализирует новый экземпляр SqlGeometry класса.

Свойства

	Имя	Описание
	HasM	Возвращает значение true, если хотя бы одна из точек пространственного объекта содержит значение M; в противном случае возвращает значение false. Это свойство предназначено только для чтения.
	HasZ	Возвращает значение true, если хотя бы одна из точек пространственного объекта содержит значение Z; в противном случае возвращает значение false. Это свойство предназначено только для чтения.
	IsNull	Возвращает значение, которое показывает, имеет ли объект SqlGeometry значение NULL.
	M	Возвращает значение M (мера) для экземпляра SqlGeometry. Семантика значения этой меры определяется пользователем.
	Null	Возвращает доступное только для чтения свойство, содержащее экземпляр типа SqlGeometry, имеющий значение NULL.
	STSrid	Возвращает или задает целое число, представляющее идентификатор пространственной ссылки (SRID) экземпляра.
	STX	Возвращает свойство координаты X экземпляра Point.
	STY	Возвращает свойство координаты Y экземпляра Point.
	Z	Возвращает значение Z (высоты) экземпляра. Семантика значения высоты определяется пользователем.

Методы

	Имя	Описание
	AsBinaryZM()	Возвращает уровень и меру как двоичный объект.
	AsGml()	Возвращает представление языка разметки Geography (GML) SqlGeometry экземпляра.
	AsTextZM()	Возвращает WKT-представление консорциума OGC для экземпляра SqlGeometry, дополненное всеми значениями Z (высота) и M (мера), находящимися в экземпляре.
	BufferWithCurves(Double)	Выполняет буферизацию объектов типа geometry с кривыми.
	BufferWithTolerance(Double, Double, Boolean)	Возвращает геометрический объект, представляющий объединение всех точек, расстояние от которых до заданного экземпляра SqlGeometry не превышает заданного значения с указанной погрешностью.
	CurveToLineWithTolerance(Double, Boolean)	Возвращает приближение из многоугольников SqlGeometry экземпляр, содержащий сегменты дуги.
	Deserialize(SqlBytes)	Возвращает сформированный объект SqlGeometry из внутреннего формата SQL Server для пространственных данных.
	Equals(Object)	(Наследуется от Object.)
	Filter(SqlGeometry)	Предоставляет быстрый метод пересечения, который используется только для индексов и определяет, пересекается ли экземпляр SqlGeometry с другим экземпляромSqlGeometry в предположении, что индекс доступен.
	GeomFromGml(SqlXml, Int32)	Создает SqlGeometry экземпляре представление SQL Server подмножестве языка разметки Geography (GML).
	GetHashCode()	(Наследуется от Object.)
	GetType()	(Наследуется от Object.)
	InstanceOf(String)	Проверяет принадлежность экземпляра SqlGeometry к указанному типу.
	IsValidDetailed()	Возвращает сообщение, помогая выявлять проблемы допустимости, возникающие с пространственным объектом.
	MakeValid()	Преобразует недопустимый экземпляр SqlGeometry в экземпляр SqlGeometry с допустимым типом OGC.
	MinDbCompatibilityLevel()	Возвращает минимальный уровень совместимости базы данных, при котором поддерживается тип SqlGeometry.
	Parse(SqlString)	Возвращает экземпляр SqlGeometry из WKT-представления консорциума OGC.
	Point(Double, Double, Int32)	Создает экземпляр SqlGeometry, представляющий экземпляр Point, по значениям X и Y и идентификатору SRID.
	Populate(IGeometrySink)	Устарело. Применяет последовательность вызова типа geometry к объекту IGeometrySink. Последовательность вызова — это упорядоченный набор фигур, линий и точек.SqlGeometry
	Populate(IGeometrySink110)	Применяет geometry последовательность вызова для типа IGeometrySink объекта.
	Read(BinaryReader)	Считывает двоичное представление типа geometry в объект SqlGeometry.SqlGeometry
	Reduce(Double)	Возвращает приближенное значение для указанного экземпляра SqlGeometry, полученное путем выполнения алгоритма Дугласа-Пекера (Douglas-Peucker) для экземпляра с заданным допуском.
	Serialize()	Возвращает байты, представляющие внутренний формат SQL Server типа SqlGeometry.
	ShortestLineTo(SqlGeometry)	Возвращает самое короткое расстояние между двумя экземплярами SqlGeometry.
	STArea()	Возвращает общую площадь поверхности экземпляра SqlGeometry.
	STAsBinary()	Возвращает представление Open Geospatial Consortium (OGC) Well-Known Binary (WKB) SqlGeometry экземпляра. Это значение не будет содержать значений Z и M, сопровождающих экземпляр.
	STAsText()	Возвращает WKT-представление OGC для экземпляра SqlGeometry. Этот текст не будет содержать значений Z (высота) и M (мера), сопровождающих экземпляр.
	STBoundary()	Задает границу экземпляра SqlGeometry.
	STBuffer(Double)	Возвращает геометрический объект, представляющий объединение всех точек, расстояние которых от экземпляра SqlGeometry меньше или равно указанному значению.
	STCentroid()	Возвращает геометрический центр экземпляра SqlGeometry, состоящего из одного или нескольких многоугольников.
	STContains(SqlGeometry)	Указывает, включает ли вызывающий экземпляр SqlGeometry другой экземпляр SqlGeometry полностью.
	STConvexHull()	Возвращает объект, представляющий выпуклую оболочку экземпляра SqlGeometry.
	STCrosses(SqlGeometry)	Определяет, пересекается ли вызывающий экземпляр SqlGeometry с указанным экземпляром SqlGeometry.
	STCurveN(Int32)	Возвращает кривую, указанную в экземпляре SqlGeometry, который является LineString, CircularString или CompoundCurve.
	STCurveToLine()	Возвращает приближение из многоугольников SqlGeometry экземпляр, содержащий сегменты дуги.
	STDifference(SqlGeometry)	Возвращает объект, представляющий точки одного экземпляра SqlGeometry, которые не находятся в пределах другого экземпляра SqlGeometry.
	STDimension()	Возвращает максимальную размерность экземпляра SqlGeometry.
	STDisjoint(SqlGeometry)	Определяет, отсутствует ли перекрытие вызывающего объекта SqlGeometry при сравнении с указанным объектом SqlGeometry.
	STDistance(SqlGeometry)	Возвращает кратчайшее расстояние от точки в экземпляре SqlGeometry до точки в указанном экземпляре SqlGeometry.
	STEndPoint()	Возвращает конечную точку SqlGeometry экземпляра.
	STEnvelope()	Возвращает минимальный выровненный по осям ограничивающий прямоугольник экземпляра.
	STEquals(SqlGeometry)	Определяет, содержит ли указанный объект SqlGeometry набор точек, идентичный вызывающему объекту SqlGeometry.
	STExteriorRing()	Возвращает внешнее кольцо экземпляра SqlGeometry, который является многоугольником.
	STGeomCollFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STGeomCollFromWKB(SqlBytes, Int32)	Возвращает экземпляр коллекции SqlGeometry из WKB-представления консорциума OGC.
	STGeometryN(Int32)	Возвращает указанный объект SqlGeometry в коллекции SqlGeometry.
	STGeometryType()	Возвращает имя типа OGC, представленное экземпляром геометрического объекта.SqlGeometry
	STGeomFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STGeomFromWKB(SqlBytes, Int32)	Возвращает SqlGeometry экземпляр из представления Open Geospatial Consortium (OGC) Well-Known Binary (WKB).
	STInteriorRingN(Int32)	Возвращает указанное внутреннее кольцо экземпляра SqlGeometry Polygon.
	STIntersection(SqlGeometry)	Возвращает объект, представляющий точки, в которых экземпляр SqlGeometry пересекается с другим экземпляром SqlGeometry.
	STIntersects(SqlGeometry)	Определяет, пересекается ли вызывающий экземпляр SqlGeometry с другим экземпляром SqlGeometry.
	STIsClosed()	Определяет, совпадают ли начальная и конечная точка вызывающего объекта SqlGeometry.
	STIsEmpty()	Указывает, пуст ли вызывающий экземпляр SqlGeometry.
	STIsRing()	Определяет, является ли вызывающий экземпляр SqlGeometry кольцом.
	STIsSimple()	Определяет, является ли вызывающий экземпляр SqlGeometry простым.
	STIsValid()	Определяет, имеет ли вызывающий экземпляр SqlGeometry правильный формат.
	STLength()	Возвращает общую длину элементов в экземпляре SqlGeometry.
	STLineFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STLineFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeometry LineString из WKB-представления консорциума OGC.
	STMLineFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STMLineFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeometry MultiLineString из WKB-представления консорциума OGC.
	STMPointFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STMPointFromWKB(SqlBytes, Int32)	Возвращает SqlGeometry экземпляра Point из представления Open Geospatial Consortium (OGC) Well-Known Binary (WKB).
	STMPolyFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из представления в формате WKT консорциума OGC с любыми значениями Z (уровень) и M (мера) экземпляра.
	STMPolyFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeometry MultiPolygon из WKB-представления консорциума OGC.
	STNumCurves()	Возвращает число кривых в одномерном массиве SqlGeometry экземпляра.
	STNumGeometries()	Возвращает количество объектов SqlGeometry, составляющих экземпляр SqlGeometry.
	STNumInteriorRing()	Возвращает количество внутренних колец экземпляра SqlGeometry Polygon.
	STNumPoints()	Возвращает суммарное количество точек в каждой из фигур в экземпляре SqlGeometry.
	STOverlaps(SqlGeometry)	Определяет, перекрывается ли указанный экземпляр SqlGeometry с текущим экземпляром SqlGeometry.
	STPointFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STPointFromWKB(SqlBytes, Int32)	Возвращает SqlGeometry экземпляра Point из представления Open Geospatial Consortium (OGC) Well-Known Binary (WKB).
	STPointN(Int32)	Возвращает конкретную точку в экземпляре SqlGeometry.
	STPointOnSurface()	Возвращает произвольную точку, которая находится внутри экземпляра SqlGeometry.
	STPolyFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeometry из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STPolyFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeometry Polygon из WKB-представления консорциума OGC.
	STRelate(SqlGeometry, String)	Определяет, связан ли вызывающий экземпляр SqlGeometry с указанным экземпляром SqlGeometry.
	STStartPoint()	Возвращает начальную точку экземпляра SqlGeometry.
	STSymDifference(SqlGeometry)	Возвращает объект, представляющий все точки, принадлежащие одному из экземпляров SqlGeometry или SqlGeometry, но не лежащие одновременно в обоих экземплярах.
	STTouches(SqlGeometry)	Определяет, касается ли указанный экземпляр SqlGeometry текущего экземпляра SqlGeometry.
	STUnion(SqlGeometry)	Возвращает объект, представляющий объединение экземпляра SqlGeometry с другим экземпляром SqlGeometry.
	STWithin(SqlGeometry)	Определяет, лежит ли текущий экземпляр SqlGeometry полностью в пределах указанного экземпляра SqlGeometry.
	ToString()	Возвращает представление Open Geospatial Consortium (OGC) Well-Known Text (WKT) SqlGeometry экземпляра, дополненное Z (высота) и значения M (Мера), сопровождающими экземпляр.(Переопределяет Object.ToString().)
	Write(BinaryWriter)	Записывает экземпляр SqlGeometry в двоичный поток.SqlGeometry

Явные реализации интерфейса

	Имя	Описание
	ISqlSpatialGridIndexable.BufferForDistanceQuery(Double, Boolean)	Возвращает буфер для запроса расстояния для SQL Geometry.
	ISqlSpatialGridIndexable.GetBoundingBoxCorners(Double, Double, Double, Double)	Возвращает значение для углов ограничивающего прямоугольника для SQL Geometry.
	ISqlSpatialGridIndexable.GetGridCoverage(Boolean, Double, Double, Double, Double, Double, Double, Int32, Int32, Boolean[,], Boolean[,], Int32, Int32, Boolean, Boolean)	Возвращает покрытие сетки SQL Geometry.
	ISqlSpatialGridIndexable.InteriorBufferForDistanceQuery(Double)	Возвращает внутренний буфер для запроса расстояния для SQL Geometry.

Комментарии

SQL Server 2016 поддерживает набор методов для пространственных данных типа geometry. Сюда входят методы географии, определенные стандартом Open Geospatial Consortium (OGC) и набор расширений Майкрософт для этого стандарта.

Потокобезопасность

Любые открытые статические элементы ( Предоставлен общий доступ в Visual Basic) этого типа являются потокобезопасными. Потокобезопасность элементов экземпляров не гарантируется.

См. также

Пространство имен Microsoft.SqlServer.Types

Вернуться в начало