TarReader.GetNextEntryAsync(Boolean, CancellationToken) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar asynkront nästa post från arkivströmmen.
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)Parametrar
- copyData
- Boolean
true för att kopiera data för posten till en ny MemoryStream. Detta är användbart när den underliggande arkivströmmen inte stöder sökning och data måste nås senare.
false om data inte ska kopieras till en ny dataström. Om den underliggande dataströmmen inte stöder sökning har användaren ansvaret att läsa och bearbeta DataStream omedelbart efter att ha anropat den här metoden.
Standardvärdet är false.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En värdeaktivitet som innehåller en TarEntry instans om en giltig post hittades eller null om slutet av arkivet har nåtts.
Undantag
Arkivet är felaktigt.
-eller-
Arkivet innehåller poster i olika format.
-eller-
Mer än en global utökad attributpost hittades i det aktuella Pax arkivet.
-eller-
Två eller flera utökade attributposter hittades i följd i det aktuella Pax arkivet.
-eller-
.NET endast 11 och senare versioner: En posts kontrollsumma är ogiltig.
Ett I/O-problem uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av GetNextEntry(Boolean).
