TarWriter.WriteEntryAsync 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.
Overload
WriteEntryAsync(TarEntry, CancellationToken) |
Secara asinkron menulis entri yang ditentukan ke dalam aliran arsip. |
WriteEntryAsync(String, String, CancellationToken) |
Secara asinkron menulis file yang ditentukan ke dalam aliran arsip sebagai entri tar. |
WriteEntryAsync(TarEntry, CancellationToken)
- Sumber:
- TarWriter.cs
- Sumber:
- TarWriter.cs
- Sumber:
- TarWriter.cs
Secara asinkron menulis entri yang ditentukan ke dalam aliran arsip.
public System.Threading.Tasks.Task WriteEntryAsync (System.Formats.Tar.TarEntry entry, System.Threading.CancellationToken cancellationToken = default);
member this.WriteEntryAsync : System.Formats.Tar.TarEntry * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- entry
- TarEntry
Entri tar untuk menulis.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas yang mewakili operasi penulisan asinkron.
Pengecualian
Jenis entri adalah HardLink atau SymbolicLink dan LinkName adalah null
atau kosong.
Aliran arsip dibuang.
entry
adalah null
.
Terjadi masalah I/O.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Sebelum menulis entri ke arsip, jika Anda menulis data ke dalam entri DataStream, pastikan untuk menggulung baliknya ke posisi awal yang diinginkan.
Ini adalah jenis entri yang didukung untuk menulis pada setiap format:
V7:
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 WriteEntry(TarEntry).
Berlaku untuk
WriteEntryAsync(String, String, CancellationToken)
- Sumber:
- TarWriter.cs
- Sumber:
- TarWriter.cs
- Sumber:
- TarWriter.cs
Secara asinkron menulis file yang ditentukan ke dalam aliran arsip sebagai entri tar.
public System.Threading.Tasks.Task WriteEntryAsync (string fileName, string? entryName, System.Threading.CancellationToken cancellationToken = default);
member this.WriteEntryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- fileName
- String
Jalur ke file untuk menulis ke arsip.
- entryName
- String
Nama file sebagaimana harus diwakili dalam arsip. Ini harus mencakup jalur relatif opsional dan nama file.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas yang mewakili operasi penulisan asinkron.
Pengecualian
Aliran arsip dibuang.
fileName
atau entryName
atau null
kosong.
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 WriteEntry(String, String).