TarReader.GetNextEntryAsync(Boolean, CancellationToken) Yöntem

Tanım

Ad Alanı:

System.Formats.Tar

Bütünleştirilmiş Kod:

System.Formats.Tar.dll

Kaynak:

TarReader.cs

Arşiv akışından bir sonraki girdiyi zaman uyumsuz olarak alır.

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)

Parametreler

copyData

Boolean

true girdisinin verilerini yeni MemoryStreambir içine kopyalamak için. Temel alınan arşiv akışı aramayı desteklemediğinde ve verilere daha sonra erişilmesi gerektiğinde bu yararlı olur.

false verilerin yeni bir akışa kopyalanmaması gerekiyorsa. Temel alınan akış aramayı desteklemiyorsa, kullanıcı bu yöntemi çağırdıktan hemen sonra değerini okuma ve işleme sorumluluğuna DataStream sahiptir.

false varsayılan değerdir.

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask<TarEntry>

Geçerli bir TarEntry giriş bulunduysa veya null arşivin sonuna ulaşıldıysa örneği içeren bir değer görevi.

Özel durumlar

InvalidDataException

Arşiv yanlış biçimlendirilmiş.

-veya-

Arşiv, farklı biçimlerde girdiler içerir.

-veya-

Geçerli Pax arşivde birden fazla Genel Genişletilmiş Öznitelik Girdisi bulundu.

-veya-

Geçerli Pax arşivde art arda iki veya daha fazla Genişletilmiş Öznitelik girdisi bulundu.

IOException

G/Ç sorunu oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetNextEntry(Boolean)özel durumlara bakın.