XmlTextWriter.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 die Ersatzzeichenentität für das Ersatzzeichenpaar.
public:
override void WriteSurrogateCharEntity(char lowChar, char highChar);public override void WriteSurrogateCharEntity (char lowChar, char highChar);override this.WriteSurrogateCharEntity : char * char -> unitPublic Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)Parameter
- lowChar
- Char
Das niedrige Ersatzzeichen. Dabei muss es sich um einen Wert zwischen 0xDC00 und 0xDFFF handeln.
- highChar
- Char
Das hohe Ersatzzeichen. Dabei muss es sich um einen Wert zwischen 0xD800 und 0xDBFF handeln.
Ausnahmen
Es wurde ein ungültiges Ersatzzeichenpaar übergeben.
Hinweise
Hinweis
Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlWriter.Create Methode und der XmlWriterSettings Klasse zu erstellenXmlWriter, um neue Funktionen zu nutzen.
Diese Methode gilt nur für Systeme, die UTF-16-Codierung verwenden.
Die Surrogate-Zeichenentität wird im Hexadezimalformat geschrieben. Der Bereich für Surrogatezeichen ist #x10000 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 in Abschnitt 3.7 des Unicode 3.0/Unicode 2.0-Standards oder abschnitt 2.2 der W3C XML 1.0-Empfehlung.