XmlWriter.WriteSurrogateCharEntity(Char, Char) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
当在派生类中被重写时，为代理项字符对生成并写入代理项字符实体。
public:
abstract void WriteSurrogateCharEntity(char lowChar, char highChar);public abstract void WriteSurrogateCharEntity (char lowChar, char highChar);abstract member WriteSurrogateCharEntity : char * char -> unitPublic MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)参数
- lowChar
- Char
低代理项。 它必须是介于 0xDC00 和 0xDFFF 之间的值。
- highChar
- Char
高代理项。 它必须是介于 0xD800 和 0xDBFF 之间的值。
例外
传递了无效的代理项字符对。
在上一次异步操作完成之前调用了 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。