TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 方法

定义

命名空间:

System.Formats.Tar

程序集:

System.Formats.Tar.dll

Source:

TarEntry.cs

将当前条目异步提取到文件系统。

public System.Threading.Tasks.Task ExtractToFileAsync (string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);

member this.ExtractToFileAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

destinationFileName

String

目标文件的路径。

overwrite

Boolean

true 如果此方法应覆盖路径中的任何现有文件系统对象， destinationFileName 则为 ; false 若要防止覆盖，则为 。

cancellationToken

CancellationToken

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

返回

Task

表示异步提取操作的任务。

例外

ArgumentNullException

destinationFileName 为 null。

ArgumentException

destinationFileName 为空。

IOException

的 destinationFileName 父目录不存在。

-或-

overwrite 是 false ，并且 中 destinationFileName已存在文件。

-或-

存在与 同名 destinationFileName的目录。

-或-

出现 I/O 问题。

InvalidOperationException

不支持条目类型。

UnauthorizedAccessException

权限不足。

OperationCanceledException

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

注解

、 或 Fifo 类型的BlockDeviceCharacterDevice文件只能在 Unix 平台中提取。

需要提升才能将 或 CharacterDevice 提取BlockDevice到磁盘。

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