Nyelv

XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metódus

Definíció

Létrehozza és megírja a helyettesítő karakter entitást a helyettesítő karakterpárhoz.

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)

Paraméterek

lowChar
Char

Az alacsony helyettes. Ennek a kettő közötti 0xDC000xDFFFértéknek kell lennie.

highChar
Char

A magas helyettes. Ennek a kettő közötti 0xD8000xDBFFértéknek kell lennie.

Kivételek

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

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

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 a #x10000 következő #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, vagy a W3C XML 1.0 javaslat 2.2-es szakaszát.

A következőre érvényes: