TarReader.GetNextEntryAsync(Boolean, CancellationToken) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Recupera in modo asincrono la voce successiva dal flusso di archiviazione.
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)Parametri
- copyData
- Boolean
true per copiare i dati della voce in un nuovo MemoryStreamoggetto . Ciò è utile quando il flusso di archiviazione sottostante non supporta la ricerca e i dati devono essere accessibili in un secondo momento.
false se i dati non devono essere copiati in un nuovo flusso. Se il flusso sottostante non supporta la ricerca, l'utente ha la responsabilità di leggere ed elaborare immediatamente DataStream dopo la chiamata a questo metodo.
Il valore predefinito è false.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Attività di valore contenente un'istanza se è stata trovata una TarEntry voce valida o null se è stata raggiunta la fine dell'archivio.
Eccezioni
L'archivio non è valido.
oppure
L'archivio contiene voci in formati diversi.
oppure
Nell'archivio corrente Pax sono state trovate più voci di attributi estesi globali.
oppure
Due o più voci degli attributi estesi sono state trovate consecutivamente nell'archivio corrente Pax .
oppure
solo .NET 11 e versioni successive: il checksum di una voce non è valido.
Si è verificato un problema di I/O.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da GetNextEntry(Boolean).
