Auf Englisch lesen

Freigeben über


XmlWriter.WriteSurrogateCharEntityAsync(Char, Char) Methode

Definition

Generiert und schreibt die Ersatzzeichenentität asynchron für das Ersatzzeichenpaar.

C#
public virtual System.Threading.Tasks.Task WriteSurrogateCharEntityAsync (char lowChar, char highChar);

Parameter

lowChar
Char

Das niedrige Ersatzzeichen. Dieses muss ein Wert zwischen 0xDC00 und 0xDFFF sein.

highChar
Char

Das hohe Ersatzzeichen. Dieses muss ein Wert zwischen 0xD800 und 0xDBFF sein.

Gibt zurück

Task

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