TarWriter.WriteEntryAsync Metode

Definisi

Ruang nama:

System.Formats.Tar

Rakitan:

System.Formats.Tar.dll

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

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

Task

Tugas yang mewakili operasi penulisan asinkron.

Pengecualian

ArgumentException

Jenis entri adalah HardLink atau SymbolicLink dan LinkName adalah null atau kosong.

ObjectDisposedException

Aliran arsip dibuang.

ArgumentNullException

entryadalah null.

IOException

Terjadi masalah I/O.

OperationCanceledException

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:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Pax, dan Gnu:

  • BlockDevice
  • CharacterDevice
  • Directory
  • Fifo
  • HardLink
  • RegularFile
  • SymbolicLink

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).

WriteEntryAsync(String, String, CancellationToken)

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

Task

Tugas yang mewakili operasi penulisan asinkron.

Pengecualian

ObjectDisposedException

Aliran arsip dibuang.

ArgumentException

fileName atau entryName atau null kosong.

IOException

Terjadi masalah I/O.

OperationCanceledException

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).