XmlWriter.WriteElementStringAsync(String, String, String, 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 ír egy elemet a megadott előtaggal, helyi névvel, névtér URI-val és értékkel.

public:
 System::Threading::Tasks::Task ^ WriteElementStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public System.Threading.Tasks.Task WriteElementStringAsync(string? prefix, string localName, string? ns, string value);

member this.WriteElementStringAsync : string * string * string * string -> System.Threading.Tasks.Task

Public Function WriteElementStringAsync (prefix As String, localName As String, ns As String, value As String) As Task

Paraméterek

prefix

String

Az elem előtagja.

localName

String

Az elem helyi neve.

ns

String

Az elem névterének URI-ja.

value

String

Az elem értéke.

Válaszok

Task

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

Lásd még

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