XmlReader.ReadOuterXmlAsync Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlReaderAsync.cs

Aszinkron módon beolvassa a tartalmat, beleértve a korrektúrát is, amely a csomópontot és annak összes gyermekét jelöli.

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadOuterXmlAsync();

public virtual System.Threading.Tasks.Task<string> ReadOuterXmlAsync();

abstract member ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>

Public Overridable Function ReadOuterXmlAsync () As Task(Of String)

Válaszok

Task<String>

Ha az olvasó egy elemen vagy attribútumcsomóponton van elhelyezve, ez a metódus az aktuális csomópont és annak összes gyermekének XML-tartalmát adja vissza, beleértve a korrektúrát is; ellenkező esetben üres sztringet ad vissza.

Kivételek

InvalidOperationException

Aszinkron XmlReader 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 "XmlReaderSettings.Async beállítása igazra" üzenet jelenik meg, ha aszinkron metódusokat szeretne használni.

Megjegyzések

Ez az aszinkron verzió ReadOuterXml, 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 ReadOuterXml()kiadott kivételeket: .

Lásd még

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