TarFile.ExtractToDirectoryAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
将表示 tar 存档的流的内容异步提取到指定的目录中。 |
| ExtractToDirectoryAsync(String, String, Boolean, CancellationToken) |
将 tar 文件的内容异步提取到指定的目录中。 |
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- 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.TaskPublic 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。
返回
表示异步提取操作的任务。
例外
source 或 destinationDirectoryName 为 null。
destinationDirectoryName找不到目录路径。
提取其中一个 tar 条目会导致文件超出指定目标目录。
- 或 -
destinationDirectoryName 为空。
- 或 -
source 不支持读取。
发生 I/O 异常。
取消令牌已取消。 此异常存储在返回的任务中。
注解
、 或 Fifo 类型的BlockDeviceCharacterDevice文件只能在 Unix 平台中提取。
需要提升才能将 或 CharacterDevice 提取BlockDevice到磁盘。
此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 ExtractToDirectory(Stream, String, Boolean)异常。
适用于
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- 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.TaskPublic 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。
返回
表示异步提取操作的任务。
例外
sourceFileName 或 destinationDirectoryName 为 null。
destinationDirectoryName找不到目录路径。
sourceFileName找不到文件路径。
发生 I/O 异常。
取消令牌已取消。 此异常存储在返回的任务中。
注解
、 或 Fifo 类型的BlockDeviceCharacterDevice文件只能在 Unix 平台中提取。
需要提升才能将 或 CharacterDevice 提取BlockDevice到磁盘。
此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 ExtractToDirectory(String, String, Boolean)异常。
