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 -> unitPublic Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)參數
- lowChar
- Char
低階的替代者。 此值必須介於 0xDC00 與 0xDFFF之間。
- highChar
- Char
高階代孕者。 此值必須介於 0xD800 與 0xDBFF之間。
例外狀況
一對無效的代理字元配對被傳遞。
備註
Note
建議您使用 XmlWriter 方法和 XmlWriter.Create 類別來建立XmlWriterSettings實例，以利用新功能。
此方法僅適用於使用 UTF-16 編碼的系統。
代理字元實體以十六進位格式書寫。 替代角色的範圍為 #x10000 。#x10FFFF 以下公式用於產生代理字元實體：（highChar - 0xD800） * + 0x400 （lowChar - 0xDC00） + 。 0x10000
對於 HTML 和 XML，文件字元集（因此數字字元參考的符號）皆基於 UCS [ISO-10646]。 因此，原始文件中的單一數字字元參考在某些情況下可能對應字串中的兩個 16 位元單位（高代理與低代理。 這些 16 位元單元稱為代理對。
如需更多關於替代符號或字元的資訊，請參閱 Unicode 3.0/Unicode 2.0 標準第 3.7 節，或 W3C XML 1.0 建議書第 2.2 節。
