XmlWriter.WriteCommentAsync(String) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlWriterAsync.cs

Belirtilen metni içeren bir açıklama <--...--> zaman uyumsuz olarak yazar.

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

Parametreler

text

String

Açıklamanın içine yerleştirecek metin.

Döndürülenler

Task

Zaman uyumsuz WriteComment 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 WriteComment. 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 WriteComment(String)oluşan özel durumlara bakın.

Ayrıca bkz.

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