ZipFileExtensions.ExtractToFileAsync 方法

定义

命名空间:: System.IO.Compression

程序集:: netstandard.dll, System.IO.Compression.ZipFile.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

名称	说明
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)	使用条目的内容和指定名称异步在文件系统上创建文件。
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)	使用条目的内容和指定名称异步在文件系统上创建文件。

ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

使用条目的内容和指定名称异步在文件系统上创建文件。

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

source: ZipArchiveEntry

要从中提取文件的 zip 存档条目。

destinationFileName: String

将保存条目内容的文件的名称。

cancellationToken: CancellationToken

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

Task

例外

UnauthorizedAccessException

调用方没有所需的权限。

ArgumentException

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

-或-

destinationFileName 指定目录。

ArgumentNullException

destinationFileName 是 null。

PathTooLongException

指定的路径、文件名或两者都超过了系统定义的最大长度。例如，在基于 Windows 的平台上，路径必须小于 248 个字符，文件名必须小于 260 个字符。

DirectoryNotFoundException

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

IOException

发生 I/O 错误。

-或-

该条目当前处于打开状态以供写入。

-或-

该条目已从存档中删除。

NotSupportedException

destinationFileName 格式无效。

-或-

此条目所属的 ZipArchive 在仅写模式下打开。

InvalidDataException

存档中缺少条目或已损坏，无法读取。

-或-

该条目已使用不支持的压缩方法进行压缩。

ObjectDisposedException

此条目所属的 ZipArchive 已被释放。

注解

允许指定路径指定相对路径或绝对路径信息。相对路径信息解释为相对于当前工作目录。

文件的最后一次写入时间设置为条目的上次写入时间。此方法不允许覆盖具有相同名称的现有文件。尝试提取显式目录（名称以目录分隔符结尾的条目）不会导致创建目录。

适用于

ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

使用条目的内容和指定名称异步在文件系统上创建文件。

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task