XmlWriter.WriteNameAsync(String) 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 menuliskan nama yang ditentukan, memastikannya adalah nama yang valid sesuai dengan rekomendasi XML 1.0 W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
public:
virtual System::Threading::Tasks::Task ^ WriteNameAsync(System::String ^ name);public virtual System.Threading.Tasks.Task WriteNameAsync(string name);abstract member WriteNameAsync : string -> System.Threading.Tasks.Task
override this.WriteNameAsync : string -> System.Threading.Tasks.TaskPublic Overridable Function WriteNameAsync (name As String) As TaskParameter
- name
- String
Nama yang akan ditulis.
Mengembalikan
Tugas yang mewakili operasi asinkron WriteName .
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 WriteName, 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 WriteName(String).
