XmlTextWriter.WriteSurrogateCharEntity(Char, Char) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

public:
 override void WriteSurrogateCharEntity(char lowChar, char highChar);

public override void WriteSurrogateCharEntity (char lowChar, char highChar);

override this.WriteSurrogateCharEntity : char * char -> unit

Public Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

低代理项。它必须是介于 0xDC00 和 0xDFFF 之间的值。

高代理项。它必须是介于 0xD800 和 0xDBFF 之间的值。

Exception

传递了无效的代理项字符对。

备注

从 .NET Framework 2.0 开始，我们建议使用XmlWriter.Create方法和XmlWriterSettings类创建XmlWriter实例，以利用新功能。

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

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

对于 HTML 和 XML，文档字符集 (因此，) 数字字符引用的表示法基于 UCS [ISO-10646]。因此，源文档中的单个数字字符引用可能对应于字符串中的两个 16 位单位， (高代理项和低代理项) 。这 16 位单位称为代理项对。