XmlReader.ReadOuterXmlAsync Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReader.cs

Asynchronně přečte obsah, včetně revizí, představující tento uzel a všechny jeho podřízené položky.

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)

Návraty

Task<String>

Pokud je čtenář umístěn na elementu nebo atribut node, tato metoda vrátí veškerý xml obsah, včetně značek, aktuální uzel a všechny jeho podřízené položky; v opačném případě vrátí prázdný řetězec.

Výjimky

InvalidOperationException

Byla XmlReader volána asynchronní metoda bez nastavení příznaku Async na true. V tomto případě je vyvolána se zprávou "Set XmlReaderSettings.Async na true, InvalidOperationException pokud chcete použít asynchronní metody."

Poznámky

Jedná se o asynchronní verzi ReadOuterXml, se stejnou funkcí. Chcete-li použít tuto metodu Async , je nutné nastavit příznak na true.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadOuterXml().

Viz také

• Asynchronní programování (C#)
• Asynchronní programování pomocí Async a Await (Visual Basic)