XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Generuje i zapisuje jednostkę znaku zastępczego dla pary znaków zastępczych.

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)

Parametry

lowChar

Char

Niski surogat. Musi to być wartość między 0xDC00 i 0xDFFF.

highChar

Char

Wysoki zastępca. Musi to być wartość między 0xD800 i 0xDBFF.

Wyjątki

Exception

Przekazano nieprawidłową parę znaków zastępczych.

Uwagi

Uwaga

Począwszy od .NET Framework 2.0, zalecamy utworzenie XmlWriter wystąpień przy użyciu metody i XmlWriterSettings klasy, aby korzystać z XmlWriter.Create nowych funkcji.

Ta metoda ma zastosowanie tylko w systemach korzystających z kodowania UTF-16.

Jednostka znaku zastępczego jest zapisywana w formacie szesnastkowym. Zakres znaków zastępczych to #x10000 #x10FFFF. Następująca formuła służy do generowania jednostki znaku zastępczego: (highChar - 0xD800) * + 0x400 ( - lowChar``0xDC00) + . 0x10000

W przypadku kodu HTML i XML zestaw znaków dokumentu (a w związku z tym notacja odwołań znaków liczbowych) jest oparty na protokole UCS [ISO-10646]. Odwołanie do pojedynczego znaku liczbowego w dokumencie źródłowym może zatem w niektórych przypadkach odpowiadać dwu 16-bitowym jednostkom w ciągu (wysoki zastępczy i niski surogat). Te 16-bitowe jednostki są określane jako para zastępcza.

Aby uzyskać więcej informacji na temat zastępczych lub znaków, zapoznaj się z sekcją 3.7 standardu Unicode 3.0/Unicode 2.0 lub sekcją 2.2 zalecenia W3C XML 1.0.