XmlWriter.WriteSurrogateCharEntity(Char, Char) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlWriter.cs

Saat ditimpa di kelas turunan, menghasilkan dan menulis entitas karakter pengganti untuk pasangan karakter pengganti.

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)

Parameter

lowChar

Char

Pengganti rendah. Ini harus berupa nilai antara 0xDC00 dan 0xDFFF.

highChar

Char

Pengganti tinggi. Ini harus berupa nilai antara 0xD800 dan 0xDBFF.

Pengecualian

ArgumentException

Pasangan karakter pengganti yang tidak valid diteruskan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini hanya berlaku pada sistem yang menggunakan pengodean UTF-16.

Entitas karakter pengganti ditulis dalam format heksadesimal. Rentang untuk karakter pengganti #x10000 ke #x10FFFF. Rumus berikut digunakan untuk menghasilkan entitas karakter pengganti: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

Untuk HTML dan XML, kumpulan karakter dokumen (dan oleh karena itu notasi referensi karakter numerik) didasarkan pada UCS [ISO-10646]. Referensi karakter numerik tunggal dalam dokumen sumber mungkin dalam beberapa kasus sesuai dengan dua unit 16-bit dalam string (pengganti tinggi dan pengganti rendah). Unit 16-bit ini disebut sebagai pasangan pengganti.

Untuk informasi lebih lanjut mengenai pengganti atau karakter, lihat bagian 3.7 dari standar Unicode 3.0/Unicode 2.0 yang terletak di https://www.unicode.org, atau bagian 2.2 dari Rekomendasi XML 1.0 W3C.

Untuk versi asinkron metode ini, lihat WriteSurrogateCharEntityAsync.