XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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 -> unit

Public 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

Exception

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.