Freigeben über


XmlWriter.WriteCommentAsync(String) Methode

Definition

Schreibt asynchron einen Kommentar <!--...-->, der den angegebenen Text enthält.

public:
 virtual System::Threading::Tasks::Task ^ WriteCommentAsync(System::String ^ text);
public virtual System.Threading.Tasks.Task WriteCommentAsync (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

Text, der in den Kommentar eingefügt werden soll.

Gibt zurück

Task

Die Aufgabe, die den asynchronen WriteComment-Vorgang darstellt.

Ausnahmen

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

- oder -

Eine asynchrone XmlWriter-Methode wurde aufgerufen, ohne das Async-Flag auf true festzulegen. In diesem Fall wird InvalidOperationException mit der Nachricht „Legen Sie XmlWriterSettings.Async auf True fest, wenn Sie die Async-Methoden verwenden möchten“ ausgelöst.

Hinweise

Dies ist die asynchrone Version von WriteComment, mit derselben Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Flag auf truefestlegen.

Gilt für

Siehe auch