XmlWriter.WriteSurrogateCharEntity(Char, Char) Metoda

Definicja

Przestrzeń nazw:
System.Xml
Zestawy:
System.Xml.dll, System.Xml.ReaderWriter.dll
Zestawy:
netstandard.dll, System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs

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 zastępca. Musi to być wartość między 0xDC00 a 0xDFFF.

highChar
Char

Wysoki zastępca. Musi to być wartość między 0xD800 a 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

Zarówno w przypadku kodu HTML, jak i XML, zestaw znaków dokumentu (i w związku z tym notacja odwołań do 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ć dwóm 16-bitowym jednostkom w ciągu (wysoki zastępca i niski zastępca). 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ącym się w https://www.unicode.orglokalizacji lub sekcją 2.2 zalecenia W3C XML 1.0.

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

Dotyczy