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 ein neues MemoryStreamzu kopieren. Dies ist hilfreich, wenn der zugrunde liegende Archivdatenstrom 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 Stream die Suche nicht unterstützt, ist der Benutzer dafür verantwortlich, unmittelbar nach dem Aufrufen dieser Methode die DataStream zu lesen und zu verarbeiten.
Der Standardwert ist false.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Ein Werttask, der eine TarEntry Instanz enthält, wenn ein gültiger Eintrag gefunden wurde oder null wenn 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 Pax Archiv wurden mehrere globale erweiterte Attribute gefunden.
Oder
Zwei oder mehr Einträge für erweiterte Attribute wurden nacheinander im aktuellen Pax Archiv gefunden.
Ein E/A-Problem ist aufgetreten.