XmlReader.ReadOuterXmlAsync 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReader.cs

非同步讀取代表該節點及其所有子節點的內容，包括標記。

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)

傳回

Task<String>

若讀取器位於元素或屬性節點上，此方法會回傳當前節點及其所有子節點的所有 XML 內容，包括標記;否則，則回傳空字串。

例外狀況

InvalidOperationException

呼叫非 XmlReader 同步方法時未將 Async 標記設為 true。 此時， InvalidOperationException 會跳出「若你想使用非同步方法，將 XmlReaderSettings.Async 設為 true」的訊息。

備註

這是 的 ReadOuterXml非同步版本，功能相同。 使用此方法時，必須將 標記設 Async 為 true。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ReadOuterXml()拋出的例外。

另請參閱

• 非同步程式設計（C#）
• 非同步與等待的非同步程式設計（Visual Basic 語言）