TarReader.GetNextEntryAsync(Boolean, CancellationToken) Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Zdroj:

TarReader.cs

Asynchronně načte další položku z archivního streamu.

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)

Parametry

copyData

Boolean

true zkopírování dat o vstupu do nového MemoryStreamsouboru . To je užitečné, když podkladový archivní stream nepodporuje hledání a data je potřeba získat přístup později.

false pokud by data neměla být zkopírována do nového datového proudu. Pokud podkladový datový proud nepodporuje hledání, uživatel má odpovědnost za čtení a zpracování DataStream ihned po volání této metody.

Výchozí hodnota je false.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.

Návraty

ValueTask<TarEntry>

Hodnota úkolu obsahující instanci TarEntry , pokud byla nalezena platná položka nebo null pokud byl dosažen konec archivu.

Výjimky

InvalidDataException

Archiv je poškozený.

nebo

Archiv obsahuje položky v různých formátech.

nebo

V aktuálním Pax archivu bylo nalezeno více než jedna položka globálních rozšířených atributů.

nebo

V aktuálním Pax archivu byly po sobě nalezeny dvě nebo více položek rozšířených atributů.

nebo

.NET pouze verze 11 a novější: Kontrolní součet položky je neplatný.

IOException

Došlo k problému s vstupně-výstupními operacemi.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané GetNextEntry(Boolean).