ZipFile.OpenReadAsync(String, CancellationToken) 方法

定义

命名空间:

System.IO.Compression

程序集:

netstandard.dll, System.IO.Compression.ZipFile.dll

Source:

ZipFile.Create.Async.cs

异步打开 ZipArchive 指定路径上的读取路径。 使用 . 打开 FileMode.Open指定的文件。

public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchive> OpenReadAsync(string archiveFileName, System.Threading.CancellationToken cancellationToken = default);

static member OpenReadAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchive>

Public Shared Function OpenReadAsync (archiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchive)

参数

archiveFileName

String

一个字符串，指定要打开存档的文件系统上的路径。 允许该路径指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。

cancellationToken

CancellationToken

用于监视取消请求的取消令牌。

返回

Task<ZipArchive>

例外

ArgumentException

archiveFileName 是长度为零的字符串，仅包含空格，或包含 InvalidPathChars 定义的一个或多个无效字符。

ArgumentNullException

archiveFileName 为 null.

PathTooLongException

指定的 archiveFileName 超出了系统定义的最大长度。

例如，在基于 Windows 的平台上，路径必须小于 248 个字符，文件名必须小于 260 个字符。

DirectoryNotFoundException

指定的 archiveFileName 无效（例如，它位于未映射的驱动器上）。

IOException

打开文件时出现未指定的 I/O 错误。

UnauthorizedAccessException

archiveFileName 指定了目录。

-或-

调用方没有所需的权限。

FileNotFoundException

找不到 archiveFileName 中指定的文件。

NotSupportedException

archiveFileName 的格式无效。

InvalidDataException

无法将指定的文件解释为 zip 文件。

OperationCanceledException

异步作被取消。