Freigeben über


XmlWriter.WriteEntityRefAsync(String) Methode

Definition

Schreibt einen Entitätsverweis asynchron als &name; aus.

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

Parameter

name
String

Der Name des Entitätsverweises.

Gibt zurück

Task

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

Gilt für

Siehe auch