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 位单位称为代理项对。
有关代理项或字符的详细信息，请参阅https://www.unicode.org
有关此方法的异步版本，请参阅 WriteSurrogateCharEntityAsync。
