IInputStream.ReadAsync(IBuffer, UInt32, InputStreamOptions) Метод

Определение

Пространство имен:

Windows.Storage.Streams

Асинхронно считывает данные из потока.

public:
 IAsyncOperationWithProgress<IBuffer ^, unsigned int> ^ ReadAsync(IBuffer ^ buffer, unsigned int count, InputStreamOptions options);

IAsyncOperationWithProgress<IBuffer, uint32_t> ReadAsync(IBuffer const& buffer, uint32_t const& count, InputStreamOptions const& options);

public IAsyncOperationWithProgress<IBuffer,uint> ReadAsync(IBuffer buffer, uint count, InputStreamOptions options);

function readAsync(buffer, count, options)

Public Function ReadAsync (buffer As IBuffer, count As UInteger, options As InputStreamOptions) As IAsyncOperationWithProgress(Of IBuffer, UInteger)

Параметры

buffer

IBuffer

Буфер, который может использоваться для возврата считываемых байтов. Возвращаемое значение содержит буфер, содержащий результаты.

count

UInt32

unsigned int

uint32_t

Число считываемых байтов, которое меньше или равно значению Capacity .

options

InputStreamOptions

Указывает тип асинхронной операции чтения.

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

IAsyncOperationWithProgress<IBuffer,UInt32>

Windows.Foundation.IAsyncOperationWithProgress<Windows.Storage.Streams.IBuffer,unsigned int>

IAsyncOperationWithProgress<IBuffer,uint32_t>

Асинхронная операция.

Примеры

Примеры приложений, использующих этот метод, включают пример HttpClient.

Комментарии

Всегда считывайте данные из буфера, возвращаемые в IAsyncOperationWithProgress(IBuffer, UInt32). Не предполагайте, что входной буфер содержит данные. В зависимости от реализации считываемые данные могут помещаться во входной буфер или возвращаться в другой буфер. Для входного буфера не нужно реализовывать интерфейс IBuffer . Вместо этого можно создать экземпляр класса Buffer .

Также рассмотрите возможность чтения буфера в IInputStream с помощью метода ReadBuffer класса DataReader .

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

• Пример HttpClient