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).

public:
 virtual System::Threading::Tasks::Task ^ WriteNameAsync(System::String ^ name);
public virtual System.Threading.Tasks.Task WriteNameAsync (string name);
abstract member WriteNameAsync : string -> System.Threading.Tasks.Task
override this.WriteNameAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteNameAsync (name As String) As Task

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

Siehe auch