Auf Englisch lesen

Freigeben über


XmlWriter.WriteNameAsync(String) Methode

Definition

Schreibt den angegebenen Namen asynchron aus und prüft dessen Gültigkeit entsprechend der W3C-Empfehlung für XML, Version 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

C#
public virtual System.Threading.Tasks.Task WriteNameAsync (string name);

Parameter

name
String

Der zu schreibende Name.

Gibt zurück

Task

Die Aufgabe, die den asynchronen WriteName-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 WriteName, mit derselben Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Kennzeichen auf truefestlegen.

Gilt für

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Siehe auch