System.Xml.XmlTextWriter.WriteSurrogateCharEntity 方法

上一篇：System.Xml.XmlTextWriter.WriteString 方法下一篇：System.Xml.XmlTextWriter.WriteWhitespace 方法

方法描述

为代理项字符对生成并编写代理项字符实体。

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

public override void WriteSurrogateCharEntity(
	char lowChar,
	char highChar
)

参数/返回值

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

提示和注释

注意

在 .NET Framework 2.0 版版本中，推荐的做法是使用 XmlWriter.Create 方法和 XmlWriterSettings 类创建 XmlWriter 实例。这使您可以充分利用此版本中引入的所有新功能。有关更多信息，请参见创建 XML 编写器。

此方法仅适用于使用 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 节。