XmlWriter.WriteSurrogateCharEntity(Char, Char) Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Po zastąpieniu w klasie pochodnej generuje i zapisuje jednostkę znaku zastępczego dla pary znaków zastępczych.

public:
 abstract void WriteSurrogateCharEntity(char lowChar, char highChar);

public abstract void WriteSurrogateCharEntity (char lowChar, char highChar);

abstract member WriteSurrogateCharEntity : char * char -> unit

Public MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

Parametry

lowChar

Char

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

highChar

Char

Wysoki surogat. Musi to być wartość z zakresu od 0xD800 do 0xDBFF.

Wyjątki

ArgumentException

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

InvalidOperationException

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

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 jest #x10000 #x10FFFF. Następująca formuła służy do generowania jednostki znaku zastępczego: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

W przypadku języków HTML i XML zestaw znaków dokumentu (i w związku z tym notacja odwołań do znaków liczbowych) jest oparty na standardzie UCS [ISO-10646]. W niektórych przypadkach odwołanie do pojedynczego znaku liczbowego w dokumencie źródłowym może w niektórych przypadkach odpowiadać dwóm jednostkom 16-bitowym w ciągu (wysoki zastępca 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 znajdującą się w https://www.unicode.orglokalizacji lub sekcją 2.2 zalecenia W3C XML 1.0.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteSurrogateCharEntityAsync.