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

定义

异步读取嵌入在 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

要复制到缓冲区中的最大字符数。 此方法返回复制的实际字符数。

返回

读取到缓冲区中的字符数。 如果不再有文本内容,则返回值零。

例外

在上一次异步操作完成之前调用了 XmlReader 方法。 在这种情况下, InvalidOperationException 会引发 ,并显示消息“异步操作已在进行中”。-或-

调用了 XmlReader 异步方法,但未将 Async 标志设置为 true。 在此情况下,将引发 InvalidOperationException 并显示消息“若要使用 Async 方法,请将 XmlReaderSettings.Async 设置为 True。”

注解

这是 具有相同功能的异步版本 ReadValueChunk。 若要使用此方法,必须将 标志设置为 Asynctrue

适用于

另请参阅