XmlWriter.WriteStartElementAsync(String, String, String) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlWriterAsync.cs

Belirtilen başlangıç etiketini zaman uyumsuz olarak yazar ve belirtilen ad alanı ve ön ek ile ilişkilendirir.

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

Parametreler

prefix

String

öğesinin ad alanı ön eki.

localName

String

Öğesinin yerel adı.

ns

String

öğesiyle ilişkilendirilecek ad alanı URI'si.

Döndürülenler

Task

Zaman uyumsuz WriteStartElement işlemi temsil eden görev.

Özel durumlar

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

-veya-

XmlWriter bayrağı trueolarak ayarlanmadan Async zaman uyumsuz bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Async Yöntemleri kullanmak istiyorsanız XmlWriterSettings.Async değerini true olarak ayarlayın" iletisiyle oluşturulur.

Açıklamalar

Bu, aynı işlevselliğe sahip zaman uyumsuz sürümüdür WriteStartElement. Bu yöntemi kullanmak için bayrağını Async olarak trueayarlamanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından WriteStartElement(String, String, String)oluşan özel durumlara bakın.

Ayrıca bkz.

• Zaman uyumsuz programlama (C#)
• Async ve Await ile zaman uyumsuz programlama (Visual Basic)