XmlWriter.WriteSurrogateCharEntityAsync(Char, Char) Metódus

Definíció

Névtér:

System.Xml

Szerelvény:

System.Xml.dll

Aszinkron módon létrehozza és megírja a helyettesítő karakter entitást a helyettesítő karakterpárhoz.

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

Public Overridable Function WriteSurrogateCharEntityAsync (lowChar As Char, highChar As Char) As Task

Paraméterek

lowChar

Char

Az alacsony helyettes. Ennek 0xDC00 és 0xDFFF közötti értéknek kell lennie.

highChar

Char

A magas helyettes. Ennek 0xD800 és 0xDBFF közötti értéknek kell lennie.

Válaszok

Task

Az aszinkron WriteSurrogateCharEntity műveletet képviselő feladat.

Kivételek

InvalidOperationException

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

-vagy-

Aszinkron XmlWriter metódust hívtak meg anélkül, hogy a jelölőt a Async következőre trueállítanák. Ebben az esetben InvalidOperationException az "XmlWriterSettings.Async beállítása igazra" üzenet jelenik meg, ha aszinkron metódusokat szeretne használni.

Megjegyzések

Ez az aszinkron verzió WriteSurrogateCharEntity, ugyanazzal a funkcióval. A metódus használatához be kell állítania a jelölőt a Async következőre true: .

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által WriteSurrogateCharEntity(Char, Char)kiadott kivételeket: .

Lásd még

• Aszinkron programozás (C#)
• Aszinkron programozás az Async és a Await (Visual Basic)