XmlWriter.WriteStartElementAsync(String, String, String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlWriterAsync.cs

Secara asinkron menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace dan awalan yang diberikan.

public:
 virtual System::Threading::Tasks::Task ^ WriteStartElementAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public virtual System.Threading.Tasks.Task WriteStartElementAsync(string? prefix, string localName, string? ns);

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

Public Overridable Function WriteStartElementAsync (prefix As String, localName As String, ns As String) As Task

Parameter

prefix

String

Awalan namespace elemen.

localName

String

Nama lokal elemen .

ns

String

URI namespace untuk dikaitkan dengan elemen .

Mengembalikan

Task

Tugas yang mewakili operasi asinkron WriteStartElement .

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

Lihat juga

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