Freigeben über


XmlWriter.WriteSurrogateCharEntity(Char, Char) Methode

Definition

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

Es wurde ein ungültiges Ersatzzeichenpaar übergeben.

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.

Gilt für