XmlReader.MoveToContentAsync 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReaderAsync.cs

非同步檢查目前節點是否為內容節點。 若該節點不是內容節點，讀取器會跳到下一個內容節點或檔案的結尾。

public:
 virtual System::Threading::Tasks::Task<System::Xml::XmlNodeType> ^ MoveToContentAsync();

public virtual System.Threading.Tasks.Task<System.Xml.XmlNodeType> MoveToContentAsync();

abstract member MoveToContentAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlNodeType>
override this.MoveToContentAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlNodeType>

Public Overridable Function MoveToContentAsync () As Task(Of XmlNodeType)

傳回

Task<XmlNodeType>

是 NodeType 方法所找到的當前節點，或 XmlNodeType.None 是讀取器是否已到達輸入串流的終點。

例外狀況

InvalidOperationException

在先前非同步操作結束前，會呼叫一個 XmlReader 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

-或-

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

備註

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

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

另請參閱

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