XmlWriter.WriteElementStringAsync(String, String, String, String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlWriterAsync.cs

Menulis elemen secara asinkron dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.

public:
 System::Threading::Tasks::Task ^ WriteElementStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public System.Threading.Tasks.Task WriteElementStringAsync(string? prefix, string localName, string? ns, string value);

member this.WriteElementStringAsync : string * string * string * string -> System.Threading.Tasks.Task

Public Function WriteElementStringAsync (prefix As String, localName As String, ns As String, value As String) As Task

Parameter

prefix

String

Awalan elemen.

localName

String

Nama lokal elemen .

ns

String

URI namespace elemen.

value

String

Nilai dari elemen.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron WriteElementString .

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

Lihat juga

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