XmlWriter.WriteSurrogateCharEntity-Methode

Generiert und schreibt beim Überschreiben in einer abgeleiteten Klasse die Ersatzzeichenentität für das Ersatzzeichenpaar.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public MustOverride Sub WriteSurrogateCharEntity ( _
    lowChar As Char, _
    highChar As Char _
)
'Usage
Dim instance As XmlWriter
Dim lowChar As Char
Dim highChar As Char

instance.WriteSurrogateCharEntity(lowChar, highChar)

public abstract void WriteSurrogateCharEntity (
    char lowChar,
    char highChar
)

public:
virtual void WriteSurrogateCharEntity (
    wchar_t lowChar, 
    wchar_t highChar
) abstract

public abstract void WriteSurrogateCharEntity (
    char lowChar, 
    char highChar
)

public abstract function WriteSurrogateCharEntity (
    lowChar : char, 
    highChar : char
)

Parameter

• lowChar
  Das niedrige Ersatzzeichen. Dieses muss ein Wert zwischen 0xDC00 und 0xDFFF sein.

• highChar
  Das hohe Ersatzzeichen. Dieses muss ein Wert zwischen 0xD800 und 0xDBFF sein.

Ausnahmen

Hinweise

Diese Methode kann nur in Systemen angewendet werden, die UTF-16-Codierung verwenden.

Die Ersatzzeichenentität wird im Hexadezimalformat geschrieben. Der Bereich für Ersatzzeichen erstreckt sich von #x10000 bis #x10FFFF. Die Ersatzzeichenentität wird mit folgender Formel generiert: (highChar-0xD800) * 0x400 + (lowChar-0xDC00) + 0x10000

Bei HTML und XML beruht der Zeichensatz für das Dokument (und daher die Notation der numerischen Zeichenverweise) auf UCS [ISO-10646]. In einigen Fällen kann daher ein einzelner numerischer Zeichenverweis in einem Quelldokument zwei 16-Bit-Einheiten in einer Zeichenfolge (einem hohen und einem niedrigen Ersatzzeichen) entsprechen. Diese 16-Bit-Einheiten werden als Ersatzzeichenpaar bezeichnet.

Weitere Information zu Ersatzzeichen oder Zeichen finden Sie im Abschnitt 3.7 des Unicode 3.0- bzw. Unicode 2.0-Standards unter http://www.unicode.org oder im Abschnitt 2.2 der W3C-Empfehlung zu XML, Version 1.0, unter http://www.w3.org/TR/REC-xml\#charsets.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlWriter-Klasse
XmlWriter-Member
System.Xml-Namespace

Weitere Ressourcen

Schreiben von XML mit dem "XmlWriter"