TarWriter.WriteEntryAsync 方法

定义

命名空间:

System.Formats.Tar

程序集:

System.Formats.Tar.dll

重载

WriteEntryAsync(TarEntry, CancellationToken)	将指定的条目异步写入存档流。
WriteEntryAsync(String, String, CancellationToken)	将指定的文件作为 tar 条目异步写入存档流。

WriteEntryAsync(TarEntry, CancellationToken)

Source:

TarWriter.cs

将指定的条目异步写入存档流。

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

参数

entry

TarEntry

要写入的 tar 条目。

cancellationToken

CancellationToken

要监视取消请求的标记。 默认值为 None。

返回

Task

表示异步写入操作的任务。

例外

ArgumentException

条目类型为 HardLink 或 SymbolicLink ，为 LinkNamenull 或 空。

ObjectDisposedException

存档流被释放。

ArgumentNullException

entry 为 null。

IOException

出现 I/O 问题。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

在将条目写入存档之前，如果将数据写入到条目的 DataStream中，请确保将其倒退到所需的开始位置。

以下是每种格式上支持写入的条目类型：

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar、 Pax和 Gnu：

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

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteEntry(TarEntry)异常。

WriteEntryAsync(String, String, CancellationToken)

Source:

TarWriter.cs

将指定的文件作为 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

参数

fileName

String

要写入存档的文件的路径。

entryName

String

应在存档中表示的文件的名称。 它应包含可选的相对路径和文件名。

cancellationToken

CancellationToken

要监视取消请求的标记。 默认值为 None。

返回

Task

表示异步写入操作的任务。

例外

ObjectDisposedException

存档流被释放。

ArgumentException

fileName 或 entryName 为 null 或为空。

IOException

出现 I/O 问题。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteEntry(String, String)异常。