XmlWriter.WriteCommentAsync(String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlWriterAsync.cs

Secara asinkron menuliskan komentar <--...--> berisi teks yang ditentukan.

public:
 virtual System::Threading::Tasks::Task ^ WriteCommentAsync(System::String ^ text);

public virtual System.Threading.Tasks.Task WriteCommentAsync(string? text);

abstract member WriteCommentAsync : string -> System.Threading.Tasks.Task
override this.WriteCommentAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteCommentAsync (text As String) As Task

Parameter

text

String

Teks untuk ditempatkan di dalam komentar.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron WriteComment .

Pengecualian

InvalidOperationException

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 WriteComment, 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 WriteComment(String).

Lihat juga

• Pemrograman asinkron (C#)
• Pemrograman asinkron dengan Asinkron dan Tunggu (Visual Basic)