TarReader.GetNextEntryAsync(Boolean, CancellationToken) 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.
Recupera assíncronamente a próxima entrada do fluxo de arquivo.
public System.Threading.Tasks.ValueTask<System.Formats.Tar.TarEntry?> GetNextEntryAsync(bool copyData = false, System.Threading.CancellationToken cancellationToken = default);member this.GetNextEntryAsync : bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Formats.Tar.TarEntry>Public Function GetNextEntryAsync (Optional copyData As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TarEntry)Parâmetros
- copyData
- Boolean
true para copiar os dados da entrada num novo MemoryStream. Isto é útil quando o fluxo de arquivo subjacente não suporta a procura, e os dados precisam de ser acedidos mais tarde.
false se os dados não devem ser copiados para um novo fluxo. Se o fluxo subjacente não suportar a procura, o utilizador tem a responsabilidade de ler e processar imediatamente DataStream após chamar este método.
O valor predefinido é false.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa de valor contendo uma TarEntry instância se foi encontrada uma entrada válida, ou null se o fim do arquivo foi alcançado.
Exceções
O arquivo está deformado.
-ou-
O arquivo contém entradas em diferentes formatos.
-ou-
Mais do que uma Entrada Global Extended Attributes foi encontrada no arquivo atual Pax .
-ou-
Duas ou mais entradas de Atributos Estendidos foram encontradas consecutivamente no arquivo atual Pax .
-ou-
.NET 11 e versões posteriores apenas: A soma de verificação de uma entrada é inválida.
Ocorreu um problema de I/O.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
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 GetNextEntry(Boolean).
