TarReader.GetNextEntryAsync(Boolean, CancellationToken) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Secara asinkron mengambil entri berikutnya dari aliran arsip.
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 untuk menyalin data entri ke baru MemoryStream. Ini berguna ketika aliran arsip yang mendasar tidak mendukung pencarian, dan data perlu diakses nanti.
false jika data tidak boleh disalin ke aliran baru. Jika aliran yang mendasar tidak mendukung pencarian, pengguna memiliki tanggung jawab untuk membaca dan memproses DataStream segera setelah memanggil metode ini.
Nilai defaultnya adalah false.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas nilai yang TarEntry berisi instans jika entri yang valid ditemukan, atau null jika akhir arsip telah tercapai.
Pengecualian
Arsip cacat.
-atau-
Arsip berisi entri dalam format yang berbeda.
-atau-
Lebih dari satu Entri Atribut Global Yang Diperluas ditemukan dalam arsip saat ini Pax .
-atau-
Dua atau beberapa entri Atribut yang Diperluas ditemukan berturut-turut dalam arsip saat ini Pax .
Terjadi masalah I/O.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh GetNextEntry(Boolean).
