XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReaderAsync.cs

非同步讀取嵌入 XML 文件中的大量文字串流。

public:
 virtual System::Threading::Tasks::Task<int> ^ ReadValueChunkAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task<int> ReadValueChunkAsync(char[] buffer, int index, int count);

abstract member ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>

Public Overridable Function ReadValueChunkAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)

參數

buffer

Char[]

作為文字內容寫入緩衝區的字元陣列。 這個值不能是 null。

index

Int32

緩衝區內的偏移量，可以 XmlReader 開始複製結果。

count

Int32

複製到緩衝區的最大字元數。 此方法會回傳實際複製的字元數。

傳回

Task<Int32>

讀取到緩衝區的字元數。 當文字內容不再存在時，值為零。

例外狀況

InvalidOperationException

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

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

備註

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

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

另請參閱

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