StringReader.ReadBlockAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| ReadBlockAsync(Memory<Char>, CancellationToken) |
Асинхронно считывает все символы из входной строки, начиная с текущей позиции, и перемещает текущую позицию в конец входной строки. |
| ReadBlockAsync(Char[], Int32, Int32) |
Считывает указанное максимальное количество символов из текущей строки асинхронно и записывает данные в буфер, начиная с указанного индекса. |
ReadBlockAsync(Memory<Char>, CancellationToken)
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
Асинхронно считывает все символы из входной строки, начиная с текущей позиции, и перемещает текущую позицию в конец входной строки.
public override System.Threading.Tasks.ValueTask<int> ReadBlockAsync(Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Overrides Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Параметры
Когда этот метод возвращается, содержит символы, считыванные из текущего источника. Если общее число символов чтения равно нулю, диапазон остается неизменен.
- cancellationToken
- CancellationToken
Маркер для отслеживания запросов на отмену. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию чтения. Значение TResult параметра содержит общее количество символов, считываемых в буфер.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
ReadBlockAsync(Memory<Char>, CancellationToken) вызывается ReadBlock(Span<Char>) асинхронно, что в свою очередь вызывает Read(Span<Char>) напрямую.
Применяется к
ReadBlockAsync(Char[], Int32, Int32)
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
- Исходный код:
- StringReader.cs
Считывает указанное максимальное количество символов из текущей строки асинхронно и записывает данные в буфер, начиная с указанного индекса.
public:
override System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);public override System.Threading.Tasks.Task<int> ReadBlockAsync(char[] buffer, int index, int count);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<int> ReadBlockAsync(char[] buffer, int index, int count);override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>Public Overrides Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)Параметры
- buffer
- Char[]
При возврате этого метода содержит указанный массив символов со значениями между index и (index + count - 1), замененными символами, считываемыми из текущего источника.
- index
- Int32
Позиция, с которой buffer начать писать.
- count
- Int32
Максимальное число символов для чтения. Если конец строки достигнут до того, как указанное число символов записывается в буфер, метод возвращается.
Возвращаемое значение
Задача, представляющая асинхронную операцию чтения. Значение TResult параметра содержит общее количество байтов, считываемых в буфер. Значение результата может быть меньше числа запрошенных байтов, если число доступных в данный момент байтов меньше запрошенного числа или может быть равно 0 (ноль), если достигнут конец строки.
- Атрибуты
Исключения
buffer равно null.
index или count отрицательный.
index Сумма и count больше длины буфера.
Средство чтения строк удалено.
В настоящее время средство чтения используется предыдущей операцией чтения.
Комментарии
Задача не завершается до тех пор, пока не будет достигнуто число символов, указанных count параметром, или конец строки.
