SqlGeography 类

项目
11/09/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	获取或设置一个 ID，该 ID 是一个表示该实例的空间引用标识符 (SRID) 的整数。
	Z	获取实例的 Z（标高）值。标高值的语义是用户定义的。

方法

	名称	说明
	AsBinaryZM()	返回 SqlGeography 实例的开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式，增加了该实例传递的任何 Z（标高）和 M（度量）值。
	AsGml()	返回 SqlGeography 实例的地理标记语言 (GML) 表示形式。
	AsTextZM()	返回的开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式 SqlGeography 实例增强任何 Z （标高）和 M （度量）值，使该实例传递的。
	BufferWithCurves(Double)	返回一个 SqlGeography 实例，它表示与调用 SqlGeography 实例的距离小于或等于 distance 参数的所有点的集合。
	BufferWithTolerance(Double, Double, Boolean)	返回表示所有点值的并集的几何对象，这些点到 SqlGeography 实例的距离小于或等于指定值，允许存在指定的公差。
	CurveToLineWithTolerance(Double, Boolean)	返回的多边形近似 SqlGeography 包含圆弧线段的实例。
	Deserialize(SqlBytes)	从空间数据的内部 SQL Server 格式返回构建的 SqlGeometry。可用于通过网络发送空间数据或从文件中读取这些空间数据。
	EnvelopeAngle()	返回 EnvelopeCenter 返回的点与 SqlGeography 实例中的点之间的最大角度（以度数为单位）。
	EnvelopeCenter()	返回一个点，该点可用作地域实例的边框圆的圆心。
	Equals(Object)	（继承自 Object。）
	Filter(SqlGeography)	提供了一种快速、仅索引相交方法，可确定一个地域实例是否与另一个 SqlGeography 实例相交（假定有索引可用）。
	GeomFromGml(SqlXml, Int32)	根据地理标记语言 (GML) 的 SQL Server 子集中的给定表示形式构造 SqlGeography 实例。
	GetHashCode()	（继承自 Object。）
	GetType()	（继承自 Object。）
	InstanceOf(String)	测试 SqlGeography 实例是否与指定的类型相同。
	IsValidDetailed()	返回帮助标识空间对象的有效性问题的消息。
	MakeValid()	将无效的 geography 实例转换为具有有效开放地理空间信息联盟 (OGC) 类型的有效 geography 实例。
	MinDbCompatibilityLevel()	返回接受的最基本的数据库兼容级别 SqlGeography 类型。
	NumRings()	返回 Polygon 实例中的总环数。
	Parse(SqlString)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式的实例。
	Point(Double, Double, Int32)	根据一个 Point 实例的 X 和 Y 值以及空间引用 ID (SRID) 构造一个表示该实例的 SqlGeography 实例。
	Populate(IGeographySink)	已过时。将geography类型调用序列应用于 IGeographySink 对象。调用序列是geography类型的图、线和点的集合。
	Populate(IGeographySink110)	将geography类型调用序列应用于 IGeographySink 对象。
	Read(BinaryReader)	读取的二进制表示形式 geography 键入 SqlGeometry 对象。
	Reduce(Double)	返回给定地域实例的近似值，该值通过对实例运行具有给定公差的 Douglas-Peucker 算法来生成。
	ReorientObject()	返回 geography 实例以及互换的内部区域和外部区域。
	RingN(Int32)	返回 SqlGeography 实例的指定环：1 ≤ n ≤ NumRings()。
	Serialize()	用于跨网络发送空间数据。
	ShortestLineTo(SqlGeography)	返回两者之间的最短距离 SqlGeography实例。
	STArea()	返回的总表面积 SqlGeography 实例。
	STAsBinary()	返回 SqlGeography 实例的开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式。
	STAsText()	返回 SqlGeography 实例的开放地理空间信息联盟 (OGC) 熟知文本 (WKT) 表示形式。
	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)	从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式返回地域实例，增加了该实例传递的任何 Z（标高）和 M（度量）值。
	STGeomCollFromWKB(SqlBytes, Int32)	从开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式返回 GeometryCollection 实例。
	STGeometryN(Int32)	返回 GeometryCollection 或其子类型之一中的指定地理元素。
	STGeometryType()	返回由地域实例表示的开放地理空间联盟 (OGC) 类型名称。
	STGeomFromText(SqlChars, Int32)	返回 SqlGeography 实例从增加任何 Z （标高）和 M （度量）值的开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示该实例传递的。
	STGeomFromWKB(SqlBytes, Int32)	从开放地理空间信息联盟 (OGC) 熟知二进制 (WKB) 表示形式返回 SqlGeography 实例。
	STIntersection(SqlGeography)	返回一个对象，该对象表示一个 SqlGeography 实例与另一个 SqlGeography 实例的交点。
	STIntersects(SqlGeography)	确定当前 SqlGeography 实例是否与指定的 SqlGeography 实例相交。
	STIsClosed()	确定调用 SqlGeography 实例是否为闭合实例。
	STIsEmpty()	确定 SqlGeography 实例是否为空。
	STIsValid()	根据 geography 实例的开放地理空间联盟 (OGC) 类型，指定该实例的格式是否正确并将其识别为有效地理对象。
	STLength()	返回 SqlGeography 实例中元素的总长度或 GeometryCollection 内的 SqlGeography 实例的总长度。
	STLineFromText(SqlChars, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式，增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STLineFromWKB(SqlBytes, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式，增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STMLineFromText(SqlChars, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式，增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STMLineFromWKB(SqlBytes, Int32)	返回 SqlGeography MultiLineString 实例从开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式。
	STMPointFromText(SqlChars, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式，增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STMPointFromWKB(SqlBytes, Int32)	从开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式返回 SqlGeography MultiPoint 实例。
	STMPolyFromText(SqlChars, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式，增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STMPolyFromWKB(SqlBytes, Int32)	返回 SqlGeography MultiPolygon 实例的开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示。
	STNumCurves()	返回一维 SqlGeography 实例中的曲线数。
	STNumGeometries()	返回构成 SqlGeography 实例的几何图形的数目。
	STNumPoints()	返回处于每个图形中的点总数 SqlGeography 实例
	STOverlaps(SqlGeography)	如果 SqlGeography 实例在空间上与另一个 SqlGeography 实例重叠，则返回 1；否则，返回 0。
	STPointFromText(SqlChars, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式，增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STPointFromWKB(SqlBytes, Int32)	从开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式返回 SqlGeography Point 实例。
	STPointN(Int32)	返回 SqlGeography 实例中的指定点。
	STPolyFromText(SqlChars, Int32)	返回 SqlGeography 从开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式增加任何 Z （标高）和 M （度量）值的实例传递的实例。
	STPolyFromWKB(SqlBytes, Int32)	从开放地理空间联盟 (OGC) 熟知二进制 (WKB) 表示形式返回 SqlGeography Polygon 实例。
	STStartPoint()	返回 SqlGeography 实例的起始点。
	STSymDifference(SqlGeography)	返回表示位于一个 SqlGeography 实例或者另一个 SqlGeography 实例中的所有点的对象，但不包含同时位于这两个实例中的那些点。
	STUnion(SqlGeography)	返回一个对象，该对象表示一个 SqlGeography 实例与另一个 SqlGeography 实例的并集。
	STWithin(SqlGeography)	如果 SqlGeography 实例在空间上包含在另一个 SqlGeography 实例中，则返回 1；否则，返回 0。
	ToString()	返回的开放地理空间联盟 (OGC) 熟知文本 (WKT) 表示形式 SqlGeography 实例增强任何 Z （标高）和 M （度量）值，使该实例传递的。（覆盖 Object.ToString()。）
	Write(BinaryWriter)	写入 SqlGeography 对象写入二进制流。

显式接口实现

	名称	说明
	ISqlSpatialGridIndexable.BufferForDistanceQuery(Double, Boolean)	返回 SQL 地理的距离查询的缓冲区。
	ISqlSpatialGridIndexable.GetBoundingBoxCorners(Double, Double, Double, Double)	返回 SQL 地理的边界框角的值。
	ISqlSpatialGridIndexable.GetGridCoverage(Boolean, Double, Double, Double, Double, Double, Double, Int32, Int32, Boolean[,], Boolean[,], Int32, Int32, Boolean, Boolean)	返回 SQL 地理的网格覆盖。
	ISqlSpatialGridIndexable.InteriorBufferForDistanceQuery(Double)	返回 SQL 地理的距离查询的内部缓冲区。

备注

SQL Server 地理空间数据类型支持一组方法。这些方法包括开放地理空间联盟 (OGC) 标准和一组对该标准的 Microsoft 扩展定义的几何图形方法。

线程安全

此类型的所有公共静态（Visual Basic 中的 已共享 在 Visual Basic 中）成员都是线程安全的。不保证所有实例成员都是线程安全的。

另请参阅

Microsoft.SqlServer.Types 命名空间

返回页首

Share via