Класс SqlGeography

Статья
11/08/2016

Тип SqlGeography представляет данные в геодезической системе координат (для круглой земли).

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

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

System.Object
Microsoft.SqlServer.Types.SqlGeography

Синтаксис

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

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

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

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

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

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

Свойства

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

Методы

	Имя	Описание
	AsBinaryZM()	Возвращает представление в формате WKB консорциума OGC экземпляра SqlGeography, дополненное всеми значениями Z (уровень) и M (мера), находящимися в экземпляре.
	AsGml()	Возвращает представление экземпляра SqlGeography на языке GML.
	AsTextZM()	Возвращает экземпляр SqlGeography из представления в формате WKT консорциума OGC, дополненный всеми значениями Z (уровень) и M (мера), находящимися в экземпляре.
	BufferWithCurves(Double)	Возвращает экземпляр SqlGeography, представляющий набор всех точек, расстояние которых от вызывающего экземпляра SqlGeography меньше параметра distance или равно ему.
	BufferWithTolerance(Double, Double, Boolean)	Возвращает геометрический объект, представляющий объединение всех точек, расстояние от которых до заданного экземпляра SqlGeography не превышает заданного значения с указанной погрешностью.
	CurveToLineWithTolerance(Double, Boolean)	Возвращает приближение из многоугольников SqlGeography экземпляр, содержащий сегменты дуги.
	Deserialize(SqlBytes)	Возвращает сформированный объект SqlGeometry из внутреннего формата SQL Server для пространственных данных. Может использоваться для отправки пространственных данных по сети или их считывания из файла.
	EnvelopeAngle()	Возвращает максимальный угол между точкой, которая возвращена функцией EnvelopeCenter, и точкой в экземпляре SqlGeography в градусах.
	EnvelopeCenter()	Возвращает точку, которую можно использовать как центр ограничивающей окружности для экземпляра географического объекта.
	Equals(Object)	(Наследуется от Object.)
	Filter(SqlGeography)	Предоставляет быстрый метод пересечения, который используется только для индексов и определяет, пересекается ли экземпляр географического объекта с другим экземпляром SqlGeography в предположении, что индекс доступен.
	GeomFromGml(SqlXml, Int32)	Создает экземпляр SqlGeography по заданному представлению на используемом в SQL Server подмножестве языка GML.
	GetHashCode()	(Наследуется от Object.)
	GetType()	(Наследуется от Object.)
	InstanceOf(String)	Проверяет принадлежность экземпляра SqlGeography к указанному типу.
	IsValidDetailed()	Возвращает сообщение, помогая выявлять проблемы допустимости, возникающие с пространственным объектом.
	MakeValid()	Преобразует недопустимый экземпляр geography в допустимый экземпляр geography с допустимым типом OGC (Open Geospatial Consortium).
	MinDbCompatibilityLevel()	Возвращает минимальный базы данных уровень совместимости, принимающий SqlGeography типа.
	NumRings()	Возвращает общее количество колец в экземпляре Polygon.
	Parse(SqlString)	Возвращает SqlGeography экземпляр из представления Open Geospatial Consortium (OGC) Well-Known Text (WKT).
	Point(Double, Double, Int32)	Создает экземпляр SqlGeography, представляющий экземпляр Point, по значениям x и y и идентификатору пространственной ссылки (SRID).
	Populate(IGeographySink)	Устарело. Применяет последовательность вызова типа geography к объекту IGeographySink. Последовательность вызова — это набор фигур, линий и точек для типов geography.
	Populate(IGeographySink110)	Применяет последовательность вызова типа geography к объекту IGeographySink.
	Read(BinaryReader)	Считывает двоичное представление geography Введите в SqlGeometry объекта.
	Reduce(Double)	Возвращает приближение заданного экземпляра географического объекта, полученное путем применения алгоритма Дугласа-Пекера к экземпляру с заданной погрешностью.
	ReorientObject()	Возвращает экземпляр geography со взаимозаменяемыми внутренними и внешними областями.
	RingN(Int32)	Возвращает указанное кольцо экземпляра SqlGeography: 1 ≤ n ≤ NumRings().
	Serialize()	Используется для отправки пространственных данных по сети.
	ShortestLineTo(SqlGeography)	Возвращает кратчайшее расстояние между двумя SqlGeographyэкземпляров.
	STArea()	Возвращает общую площадь поверхности SqlGeography экземпляра.
	STAsBinary()	Возвращает представление экземпляра SqlGeography в формате WKB консорциума OGC.
	STAsText()	Возвращает WKT-представление OGC для экземпляра SqlGeography.
	STBuffer(Double)	Возвращает географический объект, представленный объединением всех точек, расстояние которых от экземпляра SqlGeography меньше или равно указанному значению.
	STContains(SqlGeography)	Указывает, содержит ли пространство вызывающего экземпляра SqlGeography экземпляр SqlGeography, переданный методу.
	STConvexHull()	Возвращает объект, представляющий выпуклую оболочку экземпляра SqlGeography.
	STCurveN(Int32)	Возвращает кривую, указанную в экземпляре SqlGeography, который является LineString, CircularString или CompoundCurve.
	STCurveToLine()	Возвращает приближение из многоугольников для экземпляра SqlGeography, содержащего сегменты дуги.
	STDifference(SqlGeography)	Возвращает объект, представляющий точки одного экземпляра SqlGeography, которые не находятся в пределах другого экземпляра SqlGeography.
	STDimension()	Возвращает максимальное измерение экземпляра SqlGeography.
	STDisjoint(SqlGeography)	Определяет, отсутствует ли перекрытие вызывающего объекта SqlGeography с указанным объектом SqlGeography.
	STDistance(SqlGeography)	Возвращает наименьшее расстояние от точки в экземпляре SqlGeography до точки в другом экземпляре SqlGeography.
	STEndPoint()	Возвращает конечную точку экземпляра SqlGeography.
	STEquals(SqlGeography)	Определяет, имеет ли указанный экземпляр SqlGeography набор точек, совпадающий с вызывающим экземпляром SqlGeography.
	STGeomCollFromText(SqlChars, Int32)	Возвращает экземпляр географического объекта из WKT-представления OGC вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.
	STGeomCollFromWKB(SqlBytes, Int32)	Возвращает экземпляр GeometryCollection из WKB-представления консорциума OGC.
	STGeometryN(Int32)	Возвращает указанный элемент geography в коллекции GeometryCollection или одном из ее подтипов.
	STGeometryType()	Возвращает имя типа OGC, представленное экземпляром географического объекта.
	STGeomFromText(SqlChars, Int32)	Возвращает SqlGeography экземпляр из представления Open Geospatial Consortium (OGC) Well-Known Text (WKT) вместе со всеми значениями M (Мера) и Z (высота), сопровождающими экземпляр.
	STGeomFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeography из WKB-представления консорциума OGC.
	STIntersection(SqlGeography)	Возвращает объект, представляющий точки, в которых экземпляр SqlGeography пересекается с другим экземпляром SqlGeography.
	STIntersects(SqlGeography)	Определяет, пересекается ли текущий экземпляр SqlGeography с указанным экземпляром SqlGeography.
	STIsClosed()	Определяет, является ли вызывающий экземпляр SqlGeography замкнутым.
	STIsEmpty()	Определяет, пуст ли экземпляр SqlGeography.
	STIsValid()	Указывает, является ли экземпляр географического объекта geography корректным и распознается ли как допустимый географический объект на основе типа OGC.
	STLength()	Возвращает общую длину элементов в экземпляре SqlGeography или в экземплярах SqlGeography в коллекции GeometryCollection.
	STLineFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeography из WKT-представления консорциума OGC, дополненный значениями Z (высота) и M (мера), переданными экземпляром.
	STLineFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeography из WKT-представления консорциума OGC, дополненный значениями Z (высота) и M (мера), переданными экземпляром.
	STMLineFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeography из WKT-представления консорциума OGC, дополненный значениями Z (высота) и M (мера), переданными экземпляром.
	STMLineFromWKB(SqlBytes, Int32)	Возвращает SqlGeography multilinestring из представления Open Geospatial Consortium (OGC) Well-Known Binary (WKB).
	STMPointFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeography из WKT-представления консорциума OGC, дополненный значениями Z (высота) и M (мера), переданными экземпляром.
	STMPointFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeography MultiPoint из WKB-представления консорциума OGC.
	STMPolyFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeography из WKT-представления консорциума OGC, дополненный значениями Z (высота) и M (мера), переданными экземпляром.
	STMPolyFromWKB(SqlBytes, Int32)	Возвращает SqlGeography multipolygon из представления Open Geospatial Consortium (OGC) Well-Known Binary (WKB).
	STNumCurves()	Возвращает количество кривых в одномерном экземпляре SqlGeography.
	STNumGeometries()	Возвращает количество геометрических объектов, составляющих экземпляр SqlGeography.
	STNumPoints()	Возвращает общее количество точек в каждой из фигур в экземпляре SqlGeography
	STOverlaps(SqlGeography)	Возвращает 1, если экземпляр SqlGeography пространственно перекрывается другим экземпляром SqlGeography. В противном случае возвращает значение 0.
	STPointFromText(SqlChars, Int32)	Возвращает экземпляр SqlGeography из WKT-представления консорциума OGC, дополненный значениями Z (высота) и M (мера), переданными экземпляром.
	STPointFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeography Point из WKB-представления консорциума OGC.
	STPointN(Int32)	Возвращает указанную точку в экземпляре SqlGeography.
	STPolyFromText(SqlChars, Int32)	Возвращает SqlGeography экземпляр из представления Open Geospatial Consortium (OGC) Well-Known Text (WKT) вместе со всеми значениями M (Мера) и Z (высота), сопровождающими экземпляр.
	STPolyFromWKB(SqlBytes, Int32)	Возвращает экземпляр SqlGeography Polygon из WKB-представления консорциума OGC.
	STStartPoint()	Возвращает начальную точку экземпляра SqlGeography.
	STSymDifference(SqlGeography)	Возвращает объект, представляющий все точки, принадлежащие одному экземпляру SqlGeography или другому экземпляру SqlGeography, но не лежащие одновременно в обоих экземплярах.
	STUnion(SqlGeography)	Возвращает объект, представляющий объединение экземпляра SqlGeography с другим экземпляром SqlGeography.
	STWithin(SqlGeography)	Возвращает 1, если экземпляр SqlGeography находится в пространстве другого экземпляра SqlGeography. В противном случае возвращается 0.
	ToString()	Возвращает экземпляр SqlGeography из представления в формате WKT консорциума OGC, дополненный всеми значениями Z (уровень) и M (мера), находящимися в экземпляре.(Переопределяет Object.ToString().)
	Write(BinaryWriter)	Записывает SqlGeography объект в двоичный поток.

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

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

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

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

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

См. также

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

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