TarReader.GetNextEntryAsync(Boolean, CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den nächsten Eintrag asynchron aus dem Archivdatenstrom ab.
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)Parameter
- copyData
- Boolean
true , um die Daten des Eintrags in einen neuen MemoryStreamzu kopieren. Dies ist hilfreich, wenn der zugrunde liegende Archivstream die Suche nicht unterstützt und auf die Daten später zugegriffen werden muss.
false , wenn die Daten nicht in einen neuen Stream kopiert werden sollen. Wenn der zugrunde liegende Datenstrom die Suche nicht unterstützt, ist der Benutzer dafür verantwortlich, unmittelbar nach dem Aufrufen dieser Methode zu DataStream lesen und zu verarbeiten.
Standardwert: false.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Ein Werttask, der eine TarEntry instance enthält, wenn ein gültiger Eintrag gefunden wurde oder null das Ende des Archivs erreicht wurde.
Ausnahmen
Das Archiv ist falsch formatiert.
Oder
Das Archiv enthält Einträge in unterschiedlichen Formaten.
Oder
Im aktuellen Archiv wurde mehr als ein Eintrag zu globalen erweiterten Attributen Pax gefunden.
Oder
Im aktuellen Archiv wurden zwei oder mehr Einträge mit erweiterten Attributen Pax nacheinander gefunden.
Ein E/A-Problem ist aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten GetNextEntry(Boolean)Ausnahmen.
