ZipFileExtensions.ExtractToDirectoryAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
将存档中的所有文件异步提取到文件系统上的目录。 指定的目录已存在。 |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
将存档中的所有文件提取到文件系统上的目录。 指定的目录可能已存在。 |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
将存档中的所有文件异步提取到文件系统上的目录。 指定的目录已存在。
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task参数
- source
- ZipArchive
要从中提取文件的 zip 存档。
- destinationDirectoryName
- String
文件系统上目录的路径。
- cancellationToken
- CancellationToken
用于监视取消请求的取消令牌。
返回
例外
destinationDirectoryName 是长度为零的字符串，仅包含空格，或包含 InvalidPathChars 定义的一个或多个无效字符。
destinationDirectoryName 是 null。
指定的路径、文件名或两者都超过了系统定义的最大长度。 例如，在基于 Windows 的平台上，路径必须小于 248 个字符，文件名必须小于 260 个字符。
指定的路径无效（例如，它位于未映射的驱动器上）。
存档项的名称为零长度，仅包含空格，或包含 InvalidPathChars 定义的一个或多个无效字符。
-或-
提取存档条目将导致目标文件超出 destinationDirectoryName （例如，如果条目名称包含父目录访问器）。
-或-
存档项与已从同一存档中提取的条目同名。
调用方没有所需的权限。
destinationDirectoryName 格式无效。
异步作被取消。
注解
指定的目录不得存在。 允许该路径指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。
此方法在必要时创建所有子目录和指定目录。
如果在提取存档时出错，存档将保持部分提取。
提取每个条目，以便提取的文件具有与该条目的根目录相同的相对路径 destinationDirectoryName 。 如果要存档的文件的上次修改时间无效，将使用 Zip 时间戳格式（1980 年 1 月 1 日午夜）表示的第一个日期/时间。
适用于
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
将存档中的所有文件提取到文件系统上的目录。 指定的目录可能已存在。
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task参数
- source
- ZipArchive
要从中提取文件的 zip 存档。
- destinationDirectoryName
- String
文件系统上目录的路径。
- overwriteFiles
- Boolean
true 覆盖文件; false 否则。
- cancellationToken
- CancellationToken
用于监视取消请求的取消令牌。
返回
例外
destinationDirectoryName 是长度为零的字符串，仅包含空格，或包含 InvalidPathChars 定义的一个或多个无效字符。
此方法将在必要时创建所有子目录和指定的目录。
如果在提取存档时出错，存档将保持部分提取。
提取每个条目，以便提取的文件具有与该条目的根目录相同的相对路径 destinationDirectoryName 。 如果要存档的文件的上次修改时间无效，将使用 Zip 时间戳格式（1980 年 1 月 1 日午夜）表示的第一个日期/时间。
destinationDirectoryName 是 null。
指定的路径无效（例如，它位于未映射的驱动器上）。
存档项的名称为零长度，仅包含空格，或包含 InvalidPathChars 定义的一个或多个无效字符。
-或-
提取存档条目将导致目标文件超出 destinationDirectoryName （例如，如果条目名称包含父目录访问器）。
-或-
存档项与已从同一存档中提取的条目同名。
调用方没有所需的权限。
destinationDirectoryName 格式无效。
注解
指定的目录不得存在。 允许该路径指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。
