TarFile.ExtractToDirectoryAsync 方法

定义

命名空间:

System.Formats.Tar

程序集:

System.Formats.Tar.dll

重载

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	将表示 tar 存档的流的内容异步提取到指定的目录中。
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	将 tar 文件的内容异步提取到指定的目录中。

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Source:

TarFile.cs

将表示 tar 存档的流的内容异步提取到指定的目录中。

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

source

Stream

包含 tar 存档的流。

destinationDirectoryName

String

应在其中提取文件系统条目的目标目录的路径。

overwriteFiles

Boolean

true 如果为 ，则覆盖 中的 destinationDirectoryName文件和目录; false 如果找到任何具有现有名称的文件或目录，则引发 。

cancellationToken

CancellationToken

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

返回

Task

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

例外

ArgumentNullException

source 或 destinationDirectoryName 为 null。

DirectoryNotFoundException

destinationDirectoryName找不到目录路径。

UnauthorizedAccessException

权限不足。

ArgumentException

提取其中一个 tar 条目会导致文件超出指定目标目录。

- 或 -

destinationDirectoryName 为空。

- 或 -

source 不支持读取。

IOException

发生 I/O 异常。

OperationCanceledException

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

注解

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

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

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

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Source:

TarFile.cs

将 tar 文件的内容异步提取到指定的目录中。

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

sourceFileName

String

要提取的 tar 文件的路径。

destinationDirectoryName

String

应在其中提取文件系统条目的目标目录的路径。

overwriteFiles

Boolean

true 如果为 ，则覆盖 中的 destinationDirectoryName文件和目录; false 如果找到任何具有现有名称的文件或目录，则引发 。

cancellationToken

CancellationToken

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

返回

Task

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

例外

ArgumentNullException

sourceFileName 或 destinationDirectoryName 为 null。

DirectoryNotFoundException

destinationDirectoryName找不到目录路径。

FileNotFoundException

sourceFileName找不到文件路径。

UnauthorizedAccessException

权限不足。

ArgumentException

提取其中一个 tar 条目会导致文件超出指定目标目录。

-或-

sourceFileName 或 destinationDirectoryName 为空。

IOException

发生 I/O 异常。

OperationCanceledException

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

注解

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

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

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