Прочитать на английском

Поделиться через


XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Метод

Определение

Асинхронно считывает большие потоки текста, внедренного в XML-документ.

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

Параметры

buffer
Char[]

Массив символов, выполняющий функции буфера, в который записывается текстовое содержимое. Это значение не может быть равно null.

index
Int32

Смещение в буфере, где XmlReader может начать копировать результаты.

count
Int32

Максимальное количество копируемых в буфер символов. Этот метод возвращает фактическое количество скопированных символов.

Возвращаемое значение

Task<Int32>

Количество символов, считанных в буфер. По окончании текстового содержимого возвращается нуль.

Исключения

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется". -или-

Асинхронный метод XmlReader вызван без присваивания флагу Async значения true. В этом случае возникает исключение InvalidOperationException с сообщением "Задайте параметру XmlReaderSettings.Async значение true, если хотите использовать асинхронные методы Async Methods".

Комментарии

Это асинхронная версия ReadValueChunk, с той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Async trueзначение .

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел