IsolatedStorageFileStream.ReadAsync Método

Definição

Namespace:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Sobrecargas

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Copia de forma assíncrona bytes do objeto IsolatedStorageFileStream em buffer atual para uma matriz de bytes.
ReadAsync(Memory<Byte>, CancellationToken)	Copia de forma assíncrona bytes do objeto IsolatedStorageFileStream em buffer atual para um intervalo da memória de bytes.

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

Origem:

IsolatedStorageFileStream.cs

Copia de forma assíncrona bytes do objeto IsolatedStorageFileStream em buffer atual para uma matriz de bytes.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

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>

Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parâmetros

buffer

Byte[]

O buffer no qual os dados serão gravados.

offset

Int32

O deslocamento no buffer no qual começar a gravar.

count

Int32

O número máximo de bytes a serem lidos.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Task<Int32>

Uma tarefa que representa a operação de leitura assíncrona. Encapsula o número total de bytes de leitura para o buffer. Isso poderá ser menor que o número de bytes solicitado se tal quantidade de bytes não estiver disponível no momento ou zero se o final do fluxo for atingido.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

O buffer parâmetro pode ser uma instância da Buffer classe ou uma matriz de um dos seguintes tipos: Byte, SByte, , Char, Int16, Int32Int64, UInt16, UInt32, UInt64, Singleou Double.

Se a operação de leitura for bem-sucedida, a posição atual do fluxo será avançada pelo número de bytes lidos. Se ocorrer uma exceção, a posição atual do fluxo permanecerá inalterada.

O ReadAsync método trata o buffer parâmetro como um bloco de bytes, independentemente de seu tipo real. Da mesma forma, os offset parâmetros e count são sempre especificados em bytes. Para buffer parâmetros diferentes de matrizes de bytes, isso significa que um índice de elemento ou o número de elementos deve ser multiplicado pelo tamanho do elemento em bytes para formar um valor correto para offset ou count.

O ReadAsync método retornará zero somente se o final do fluxo for atingido. Em todos os outros casos, ReadAsync sempre lê pelo menos um byte do fluxo antes de retornar. Se nenhum dado estiver disponível do IsolatedStorageFileStream objeto após uma chamada para ReadAsync, o método será bloqueado até que pelo menos um byte de dados possa ser retornado.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Read(Byte[], Int32, Int32).

ReadAsync(Memory<Byte>, CancellationToken)

Origem:

IsolatedStorageFileStream.cs

Copia de forma assíncrona bytes do objeto IsolatedStorageFileStream em buffer atual para um intervalo da memória de bytes.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parâmetros

buffer

Memory<Byte>

O buffer no qual os dados serão gravados.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

ValueTask<Int32>

Uma tarefa que representa a operação de leitura assíncrona. Encapsula o número total de bytes de leitura para o buffer. Isso poderá ser menor que o número de bytes solicitado se tal quantidade de bytes não estiver disponível no momento ou zero se o final do fluxo for atingido.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.