XmlWriter.WriteSurrogateCharEntity(Char, Char) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Generiert und schreibt beim Überschreiben in einer abgeleiteten Klasse die Ersatzzeichenentität für das Ersatzzeichenpaar.

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)

Parameter

lowChar

Char

Das niedrige Ersatzzeichen. Dieses muss ein Wert zwischen 0xDC00 und 0xDFFF sein.

highChar

Char

Das hohe Ersatzzeichen. Dieses muss ein Wert zwischen 0xD800 und 0xDBFF sein.

Ausnahmen

ArgumentException

Es wurde ein ungültiges Ersatzzeichenpaar übergeben.

InvalidOperationException

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

Diese Methode gilt nur für Systeme, die UTF-16-Codierung verwenden.

Die Surrogate-Zeichen-Entität wird im Hexadezimalformat geschrieben. Der Bereich für Surrogatezeichen ist #x10000, um #x10FFFF zu #x10FFFF. Die folgende Formel wird verwendet, um die Surrogate-Zeichenentität zu generieren: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

Für HTML und XML basiert der Dokumentzeichensatz (und daher die Notation numerischer Zeichenbezüge) auf UCS [ISO-10646]. Ein einzelner numerischer Zeichenbezug in einem Quelldokument kann daher in einigen Fällen zwei 16-Bit-Einheiten in einer Zeichenfolge entsprechen (eine hohe Surrogate und eine niedrige Surrogate). Diese 16-Bit-Einheiten werden als Surrogate-Paar bezeichnet.

Weitere Informationen zu Surrogaten oder Zeichen finden Sie unter Abschnitt 3.7 des Unicode 3.0/Unicode 2.0-Standards, der sich auf https://www.unicode.orgdem Standard "W3C XML 1.0" befindet, oder Abschnitt 2.2 der W3C XML 1.0-Empfehlung.

Eine asynchrone Version dieser Methode finden Sie unter WriteSurrogateCharEntityAsync.