Freigeben über

XmlTextWriter.WriteSurrogateCharEntity-Methode

Generiert und schreibt die Ersatzzeichenentität für das Ersatzzeichenpaar.

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

Syntax

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

instance.WriteSurrogateCharEntity(lowChar, highChar)

public override void WriteSurrogateCharEntity (
    char lowChar,
    char highChar
)

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

public void WriteSurrogateCharEntity (
    char lowChar, 
    char highChar
)

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

Parameter

  • lowChar
    Das niedrige Ersatzzeichen. Dabei muss es sich um einen Wert zwischen 0xDC00 und 0xDFFF handeln.
  • highChar
    Das hohe Ersatzzeichen. Dabei muss es sich um einen Wert zwischen 0xD800 und 0xDBFF handeln.

Ausnahmen

Ausnahmetyp Bedingung

Exception

Es wurde ein ungültiges Ersatzzeichenpaar übergeben.

Hinweise

Hinweis

Die empfohlene Vorgehensweise für die Version Microsoft .NET Framework, Version 2.0 besteht darin, mithilfe der System.Xml.XmlWriter.Create-Methode und der XmlWriterSettings-Klasse XmlWriter-Instanzen zu erstellen. So können Sie alle neuen Features dieser Version in vollem Umfang nutzen. Weitere Informationen finden Sie unter Erstellen von XML-Writern.

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 ist #x10000 bis #x10FFFF. Die Ersatzzeichenentität wird mithilfe der folgenden 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

XmlTextWriter-Klasse
XmlTextWriter-Member
System.Xml-Namespace

  • Last updated on