XmlWriter.WriteSurrogateCharEntityAsync(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.
Secara asinkron menghasilkan dan menulis entitas karakter pengganti untuk pasangan karakter pengganti.
public:
virtual System::Threading::Tasks::Task ^ WriteSurrogateCharEntityAsync(char lowChar, char highChar);public virtual System.Threading.Tasks.Task WriteSurrogateCharEntityAsync(char lowChar, char highChar);abstract member WriteSurrogateCharEntityAsync : char * char -> System.Threading.Tasks.Task
override this.WriteSurrogateCharEntityAsync : char * char -> System.Threading.Tasks.TaskPublic Overridable Function WriteSurrogateCharEntityAsync (lowChar As Char, highChar As Char) As TaskParameter
- lowChar
- Char
Pengganti rendah. Ini harus berupa nilai antara 0xDC00 dan 0xDFFF.
- highChar
- Char
Pengganti tinggi. Ini harus berupa nilai antara 0xD800 dan 0xDBFF.
Mengembalikan
Tugas yang mewakili operasi asinkron WriteSurrogateCharEntity .
Pengecualian
Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."
-atau-
Metode XmlWriter asinkron dipanggil tanpa mengatur Async bendera ke true. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Atur XmlWriterSettings.Async ke true jika Anda ingin menggunakan Metode Asinkron."
Keterangan
Ini adalah versi asinkron dari WriteSurrogateCharEntity, dengan fungsionalitas yang sama. Untuk menggunakan metode ini, Anda harus mengatur Async bendera ke true.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh WriteSurrogateCharEntity(Char, Char).
