System.Xml.XmlWriter.WriteSurrogateCharEntity 方法

方法描述

当在派生类中被重写时,为代理项字符对生成并编写代理项字符实体。

语法定义(C# System.Xml.XmlWriter.WriteSurrogateCharEntity 方法 的用法)

public abstract void WriteSurrogateCharEntity(
	char lowChar,
	char highChar
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
lowChar System-Char 低代理项。它必须是介于 0xDC00 和 0xDFFF 之间的值。
highChar System-Char 高代理项。它必须是介于 0xD800 和 0xDBFF 之间的值。
返回值 void

提示和注释

此方法仅适用于使用 UTF-16 编码方式的系统。

以十六进制格式编写代理项字符实体。 代理项字符的范围为 #x10000 到 #x10FFFF。 下面的公式用于生成代理项字符实体:(highChar -0xD800) * 0x400 + ( lowChar -0xDC00) + 0x10000

对于 HTML 和 XML,文档字符集(以及因此而得出的数字字符引用表示法)基于 UCS [ISO-10646]。 因此,在某些情况下,源文档中的单个数字字符引用可能与字符串中的两个 16 位单元(一个高代理项和一个低代理项)相对应。 这些 16 位单元又称为一个代理项对。

有关代理项或字符的更多信息,请参考位于 http://www.unicode.org 的 Unicode 3.0/Unicode 2.0 标准的 3.7 节或位于 http://www.w3.org/TR/REC-xml#charsets 的 W3C XML 1.0 Recommendation(W3C XML 1.0 建议)的 2.2 节。

System.Xml.XmlWriter.WriteSurrogateCharEntity 方法例子


异常

异常 异常描述
ArgumentException 传递了无效的代理项字符对。

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。