XmlWriter.WriteEntityRefAsync(String) Metódus

Definíció

Névtér:

System.Xml

Szerelvény:

System.Xml.dll

Aszinkron módon egy entitáshivatkozást ír ki a következőképpen &name;: .

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

Paraméterek

name

String

Az entitáshivatkozás neve.

Válaszok

Task

Az aszinkron WriteEntityRef 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ó WriteEntityRef, 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 WriteEntityRef(String)kiadott kivételeket: .

Lásd még

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