XmlWriter.WriteSurrogateCharEntity(Char, Char) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

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

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

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

abstract member WriteSurrogateCharEntity : char * char -> unit

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

参数

lowChar

Char

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

highChar

Char

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

例外

ArgumentException

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

InvalidOperationException

在上一次异步操作完成之前调用了 XmlWriter 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

注解

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

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

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

有关代理项或字符的详细信息，请参阅位于 W3C XML 1.0 建议的第 3.7 部分/Unicode 2.0 标准部分或 W3C XML 1.0 建议的第 2.2 部分。https://www.unicode.org

有关此方法的异步版本，请参阅 WriteSurrogateCharEntityAsync。