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

  • 參考

定義

命名空間:
System.Xml
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll

以非同步的方式讀取 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 會擲回訊息「非同步作業正在進行中。」 -或-

在未將 Async 旗標設為 true的情況下呼叫了 XmlReader 非同步方法。 在此情況下，會擲回 InvalidOperationException 與「如果您想要使用非同步方法，請將 XmlReaderSettings.Async 設為 true」的訊息。

備註

這是 的非同步版本 ReadValueChunk ，具有相同的功能。 若要使用這個方法，您必須將 Async 旗標設定為 true 。

適用於

另請參閱