XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menghasilkan dan menulis entitas karakter pengganti untuk pasangan karakter pengganti.
public:
override void WriteSurrogateCharEntity(char lowChar, char highChar);public override void WriteSurrogateCharEntity(char lowChar, char highChar);override this.WriteSurrogateCharEntity : char * char -> unitPublic Overrides 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
Pasangan karakter pengganti tidak valid diteruskan.
Keterangan
Note
Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.
Metode ini hanya berlaku pada sistem yang menggunakan pengodean UTF-16.
Entitas karakter pengganti ditulis dalam format heksadesimal. Rentang untuk karakter pengganti adalah #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 selengkapnya mengenai pengganti atau karakter, lihat bagian 3.7 dari standar Unicode 3.0/Unicode 2.0, atau bagian 2.2 dari Rekomendasi XML 1.0 W3C.
