XmlWriter.WriteNameAsync(String) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlWriterAsync.cs

Aszinkron módon írja ki a megadott nevet, biztosítva, hogy érvényes név legyen a W3C XML 1.0 javaslat (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) szerint.

public:
 virtual System::Threading::Tasks::Task ^ WriteNameAsync(System::String ^ name);

public virtual System.Threading.Tasks.Task WriteNameAsync(string name);

abstract member WriteNameAsync : string -> System.Threading.Tasks.Task
override this.WriteNameAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteNameAsync (name As String) As Task

Paraméterek

name

String

Az írandó név.

Válaszok

Task

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

Lásd még

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