XmlWriter.WriteSurrogateCharEntityAsync(Char, Char) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Generiert und schreibt asynchron die Ersatzzeichenentität für das Ersatzzeichenpaar.
public:
virtual System::Threading::Tasks::Task ^ WriteSurrogateCharEntityAsync(char lowChar, char highChar);public virtual System.Threading.Tasks.Task WriteSurrogateCharEntityAsync(char lowChar, char highChar);abstract member WriteSurrogateCharEntityAsync : char * char -> System.Threading.Tasks.Task
override this.WriteSurrogateCharEntityAsync : char * char -> System.Threading.Tasks.TaskPublic Overridable Function WriteSurrogateCharEntityAsync (lowChar As Char, highChar As Char) As TaskParameter
- lowChar
- Char
Der niedrige Ersatz. Dies muss ein Wert zwischen 0xDC00 und 0xDFFF sein.
- highChar
- Char
Der hohe Ersatz. Dies muss ein Wert zwischen 0xD800 und 0xDBFF sein.
Gibt zurück
Die Aufgabe, die den asynchronen WriteSurrogateCharEntity Vorgang darstellt.
Ausnahmen
Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.
- oder -
Eine XmlWriter asynchrone Methode wurde aufgerufen, ohne die Async Kennzeichnung auf .true In diesem Fall wird die Meldung "Set XmlWriterSettings.Async to true" ausgelöst, InvalidOperationException wenn Sie Async-Methoden verwenden möchten.
Hinweise
Dies ist die asynchrone Version von WriteSurrogateCharEntity, mit der gleichen Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Kennzeichen auf true.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteSurrogateCharEntity(Char, Char).
