UnmanagedMemoryStream.ReadAsync Método

Definição

Sobrecargas

ReadAsync(Memory<Byte>, CancellationToken)

Lê de forma assíncrona os bytes de fluxo de memória não gerenciado na região de memória.Asynchronously reads the unmanaged memory stream bytes into the memory region.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Lê de forma assíncrona o número de bytes especificado na matriz especificada.Asynchronously reads the specified number of bytes into the specified array.

ReadAsync(Memory<Byte>, CancellationToken)

Lê de forma assíncrona os bytes de fluxo de memória não gerenciado na região de memória.Asynchronously reads the unmanaged memory stream bytes into the memory region.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Parâmetros

buffer
Memory<Byte>

Quando o método assíncrono é concluído, essa região de memória contém todos os bytes lidos do fluxo de memória não gerenciado.When the asynchronous method finishes, this memory region contains all the bytes read from the unmanaged memory stream.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests. O valor padrão é None.The default value is None.

Retornos

Uma tarefa que representa a operação de leitura assíncrona e encapsula o número total de bytes lidos no buffer.A task that represents the asynchronous read operation, and wraps the total number of bytes read into the buffer.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Lê de forma assíncrona o número de bytes especificado na matriz especificada.Asynchronously reads the specified number of bytes into the specified array.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Parâmetros

buffer
Byte[]

O buffer no qual os dados serão gravados.The buffer to write the data into.

offset
Int32

O deslocamento de bytes no buffer no qual será iniciada a gravação de dados no fluxo.The byte offset in buffer at which to begin writing data from the stream.

count
Int32

O número máximo de bytes a serem lidos.The maximum number of bytes to read.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests. O valor padrão é None.The default value is None.

Retornos

Uma tarefa que representa a operação de leitura assíncrona.A task that represents the asynchronous read operation. O valor do parâmetro TResult contém o número total de bytes lidos no buffer.The value of the TResult parameter contains the total number of bytes read into the buffer. O valor do resultado poderá ser menor que o número de bytes solicitados se o número de bytes disponíveis no momento for menor que o número solicitado ou poderá ser 0 (zero) se o final do fluxo foi atingido.The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached.

Atributos

Comentários

Se ocorrer uma exceção durante a operação de leitura, ela será definida como a Task.Exception da propriedade da tarefa retornada.If an exception occurs during the read operation, it will be set as the Task.Exception of the property of the returned task.

Aplica-se a