XmlWriter.WriteSurrogateCharEntity(Char, Char) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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.