IsolatedStorageFileStream.ReadAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Copia de forma assíncrona bytes do objeto em buffer IsolatedStorageFileStream atual para uma matriz de bytes. |
| ReadAsync(Memory<Byte>, CancellationToken) |
Copia de forma assíncrona bytes do objeto em IsolatedStorageFileStream buffer atual para um intervalo de memória de bytes. |
ReadAsync(Byte[], Int32, Int32, CancellationToken)
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
Copia de forma assíncrona bytes do objeto em buffer IsolatedStorageFileStream 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 gravar os dados.
- 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 ser monitorado para solicitações de cancelamento. O valor padrão é None.
Retornos
Uma tarefa que representa a operação de leitura assíncrona. Ele encapsula o número total de bytes lidos no buffer. Isso pode ser menor do que o número de bytes solicitados se muitos bytes não estiverem disponíveis no momento ou zero se o final do fluxo for atingido.
Exceções
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, Int32, Int64, 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 ficará inalterada.
O ReadAsync método trata o buffer parâmetro como um bloco de bytes, independentemente de seu tipo real. Da mesma forma, os parâmetros e os offset parâmetros count são sempre especificados em bytes. Para buffer parâmetros que não sejam 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, ReadAsynco 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 o equivalente síncrono 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).
Aplica-se a
ReadAsync(Memory<Byte>, CancellationToken)
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
- Origem:
- IsolatedStorageFileStream.cs
Copia de forma assíncrona bytes do objeto em IsolatedStorageFileStream buffer atual para um intervalo de 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
- cancellationToken
- CancellationToken
O token a ser monitorado para solicitações de cancelamento. O valor padrão é None.
Retornos
Uma tarefa que representa a operação de leitura assíncrona. Ele encapsula o número total de bytes lidos no buffer. Isso pode ser menor do que o número de bytes solicitados se muitos bytes não estiverem disponíveis no momento ou zero se o final do fluxo for atingido.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
