IsolatedStorageFileStream.ReadAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Cópia assíncronamente bytes do objeto atualmente em IsolatedStorageFileStream buffer para um array de bytes. |
| ReadAsync(Memory<Byte>, CancellationToken) |
Cópia assíncronamente bytes do objeto atualmente em IsolatedStorageFileStream buffer 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
Cópia assíncronamente bytes do objeto atualmente em IsolatedStorageFileStream buffer para um array 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 para escrever os dados.
- offset
- Int32
O deslocamento no buffer onde se começa a escrever.
- count
- Int32
O número máximo de bytes a ler.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de leitura assíncrona. Envolve o número total de bytes lidos no bufferarquivo . Isto pode ser inferior ao número de bytes solicitados se esse número de bytes não estiver disponível atualmente, ou zero se o fim do fluxo for atingido.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O buffer parâmetro pode ser uma instância da Buffer classe, ou um array de um dos seguintes tipos: Byte, SByte, Char, Int16Int32, Int64, , UInt16, , UInt32, UInt64, Singleou Double.
Se a operação de leitura for bem-sucedida, a posição atual do fluxo é avançada pelo número de bytes lidos. Se ocorrer uma exceção, a posição atual do fluxo mantém-se inalterada.
O ReadAsync método trata o buffer parâmetro como um bloco de bytes, independentemente do seu tipo real. Da mesma forma, os offset parâmetros e count são sempre especificados em bytes. Para buffer parâmetros que não sejam arrays de bytes, isto 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 só devolverá zero se o fim do fluxo for alcançado. Em todos os outros casos, ReadAsync lê sempre pelo menos um byte do fluxo antes de regressar. Se não houver dados disponíveis do IsolatedStorageFileStream objeto após uma chamada para ReadAsync, o método bloqueará até que pelo menos um byte de dados possa ser devolvido.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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
Cópia assíncronamente bytes do objeto atualmente em IsolatedStorageFileStream buffer 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 para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de leitura assíncrona. Envolve o número total de bytes lidos no bufferarquivo . Isto pode ser inferior ao número de bytes solicitados se esse número de bytes não estiver disponível atualmente, ou zero se o fim do fluxo for atingido.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
