XmlWriter.WriteSurrogateCharEntity(Char, Char) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlWriter.cs

Ha felül van bírálva egy származtatott osztályban, létrehozza és megírja a helyettesítő karakterpár helyettesítő karaktereit.

public:
 abstract void WriteSurrogateCharEntity(char lowChar, char highChar);

public abstract void WriteSurrogateCharEntity(char lowChar, char highChar);

abstract member WriteSurrogateCharEntity : char * char -> unit

Public MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

Paraméterek

lowChar

Char

Az alacsony helyettes. Ennek 0xDC00 és 0xDFFF közötti értéknek kell lennie.

highChar

Char

A magas helyettes. Ennek 0xD800 és 0xDBFF közötti értéknek kell lennie.

Kivételek

ArgumentException

Érvénytelen helyettesítő karakterpár lett átadva.

InvalidOperationException

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

Ez a módszer csak az UTF-16 kódolást használó rendszereken alkalmazható.

A helyettesítő karakter entitás hexadecimális formátumban van megírva. A helyettesítő karakterek tartománya #x10000 #x10FFFF. A helyettesítő karakter entitás létrehozásához a következő képlet használható: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

A HTML és az XML esetében a dokumentum karakterkészlete (és így a numerikus karakterhivatkozások jelölése) az UCS-n alapul [ISO-10646]. Egy forrásdokumentum egyetlen numerikus karakterhivatkozása ezért bizonyos esetekben egy sztringben két 16 bites egységnek (magas helyettesítő és alacsony helyettesítő) felelhet meg. Ezeket a 16 bites egységeket helyettesítő párnak nevezzük.

A helyettesítőkkel vagy karakterekkel kapcsolatos további információkért tekintse meg a Unicode 3.0/Unicode 2.0 szabvány 3.7-es szakaszát, amely a https://www.unicode.org található.

A metódus aszinkron verziójáról lásd WriteSurrogateCharEntityAsync: .