XmlReader.ReadContentAsStringAsync 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReaderAsync.cs

非同步讀取當前位置的文字內容，作為 String 物件。

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

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

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

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

傳回

Task<String>

文字內容作為 String 物件。

例外狀況

InvalidOperationException

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

-或-

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

備註

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

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

另請參閱

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