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
Der niedrige Ersatz. Dies muss ein Wert zwischen 0xDC00 und 0xDFFF.
- highChar
- Char
Der hohe Ersatz. Dies muss ein Wert zwischen 0xD800 und 0xDBFF.
Ausnahmen
Es wurde ein ungültiges Ersatzzeichenpaar übergeben.
Hinweise
Note
Wir empfehlen Ihnen, XmlWriter Instanzen mithilfe der XmlWriter.Create Methode und der XmlWriterSettings Klasse zu erstellen, um von neuen Funktionen zu profitieren.
Diese Methode gilt nur für Systeme, die UTF-16-Codierung verwenden.
Die Ersatzzeichenentität wird im Hexadezimalformat geschrieben. Der Bereich für Ersatzzeichen ist #x10000 auf #x10FFFF. Die folgende Formel wird verwendet, um die Ersatzzeichenentität zu generieren: (highChar - 0xD800) * 0x400 +() + (lowChar - 0xDC00) + . 0x10000
Für HTML und XML basiert der Dokumentzeichensatz (und daher die Notation numerischer Zeichenverweise) auf UCS [ISO-10646]. Ein einzelner numerischer Zeichenbezug in einem Quelldokument entspricht daher in einigen Fällen zwei 16-Bit-Einheiten in einer Zeichenfolge (ein hoher Ersatz und ein niedriger Ersatz). Diese 16-Bit-Einheiten werden als Ersatzpaar 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.
