XmlTextWriter.WriteSurrogateCharEntity(Char, Char) 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

產生和寫入 Surrogate 字元字組的 Surrogate 字元實體。

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)

參數

lowChar

Char

低 Surrogate。 這必須是一個介於 0xDC00 和 0xDFFF 之間的值。

highChar

Char

高 Surrogate。 這必須是一個介於 0xD800 和 0xDBFF 之間的值。

例外狀況

Exception

傳送無效的 Surrogate 字元字組。

備註

注意

從 .NET Framework 2.0 開始，建議您使用 XmlWriter.Create 方法和 XmlWriterSettings 類別來建立 XmlWriter 實例，以利用新功能。

這個方法僅適用于使用 UTF-16 編碼的系統上。

Surrogate 字元實體是以十六進位格式寫入。 Surrogate 字元的範圍是 #x10000 #x10FFFF 。 下列公式可用來產生 Surrogate 字元實體： (highChar - 0xD800) * 0x400 + () - lowChar 0xDC00 + 。 0x10000

對於 HTML 和 XML，檔字元集 (，因此) 的數值字元參考標記法是以 UCS [ISO-10646] 為基礎。 因此，原始檔案中的單一數值字元參考在某些情況下，可能會對應至字串中的兩個 16 位單位， (高 Surrogate 和低 Surrogate) 。 這些 16 位單位稱為 Surrogate 配對。

如需代理或字元的詳細資訊，請參閱 Unicode 3.0/Unicode 2.0 標準的第 3.7節，或 W3C XML 1.0 建議的第 2.2 節。