ZipArchive 构造函数

定义

命名空间:

System.IO.Compression

程序集:

System.IO.Compression.dll

初始化 ZipArchive 类的新实例。

重载

ZipArchive(Stream)	从指定的流初始化 ZipArchive 类的新实例。
ZipArchive(Stream, ZipArchiveMode)	从指定的流并使用指定的模式初始化 ZipArchive 类的新实例。
ZipArchive(Stream, ZipArchiveMode, Boolean)	对于指定的模式，初始化指定流上的 ZipArchive 类的新实例，并选择性地使流保持打开状态。
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)	对于指定的模式，初始化指定流上的 ZipArchive 类的新实例，使用项名的指定编码，并选择性地使流保持打开状态。

ZipArchive(Stream)

Source:

ZipArchive.cs

从指定的流初始化 ZipArchive 类的新实例。

C#

public ZipArchive (System.IO.Stream stream);

参数

stream

Stream

包含待读取的存档的流。

例外

ArgumentException

该流已关闭或不支持读取。

ArgumentNullException

stream 为 null。

InvalidDataException

流的内容不是 zip 存档格式。

ZipArchive(Stream, ZipArchiveMode)

Source:

ZipArchive.cs

从指定的流并使用指定的模式初始化 ZipArchive 类的新实例。

C#

public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode);

参数

stream

Stream

输入流或输出流。

mode

ZipArchiveMode

一个枚举值指示 zip 存档是否用于读取、创建或更新使用。

例外

ArgumentException

流已关闭，或流的功能与模式不相匹配。

ArgumentNullException

stream 为 null。

ArgumentOutOfRangeException

mode 为无效值。

InvalidDataException

流的内容无法被解释为 zip 存档。

- 或 -

mode 是 Update，但存档中缺少项，或者项已损坏且无法读取。

- 或 -

mode 是 Update，但项太大，无法装入内存。

注解

如果 参数 mode 设置为 Read，则流必须支持读取。 如果 参数 mode 设置为 Create，则流必须支持写入。 如果 参数 mode 设置为 Update，则流必须支持读取、写入和查找。

ZipArchive(Stream, ZipArchiveMode, Boolean)

Source:

ZipArchive.cs

对于指定的模式，初始化指定流上的 ZipArchive 类的新实例，并选择性地使流保持打开状态。

C#

public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen);

参数

stream

Stream

输入流或输出流。

mode

ZipArchiveMode

一个枚举值指示 zip 存档是否用于读取、创建或更新使用。

leaveOpen

Boolean

如果在释放 ZipArchive 对象后保持流处于打开状态，则为 true；否则为 false。

例外

ArgumentException

流已关闭，或流的功能与模式不相匹配。

ArgumentNullException

stream 为 null。

ArgumentOutOfRangeException

mode 为无效值。

InvalidDataException

流的内容无法被解释为 zip 存档。

- 或 -

mode 是 Update，但存档中缺少项，或者项已损坏且无法读取。

- 或 -

mode 是 Update，但项太大，无法装入内存。

注解

如果 参数 mode 设置为 Read，则流必须支持读取。 如果 参数 mode 设置为 Create，则流必须支持写入。 如果 参数 mode 设置为 Update，则流必须支持读取、写入和查找。

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Source:

ZipArchive.cs

对于指定的模式，初始化指定流上的 ZipArchive 类的新实例，使用项名的指定编码，并选择性地使流保持打开状态。

C#

public ZipArchive (System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen, System.Text.Encoding? entryNameEncoding);

参数

stream

Stream

输入流或输出流。

mode

ZipArchiveMode

一个枚举值指示 zip 存档是否用于读取、创建或更新使用。

leaveOpen

Boolean

如果在释放 ZipArchive 对象后保持流处于打开状态，则为 true；否则为 false。

entryNameEncoding

Encoding

在存档中读取或写入项名时使用的编码。 仅当需要针对具有不支持条目名称的 UTF-8 编码的 zip 归档工具和库的互操作性进行编码时，为此参数指定值。

例外

ArgumentException

流已关闭，或流的功能与模式不相匹配。

- 或 -

为 entryNameEncoding 指定除 UTF-8 之外的编码。

ArgumentNullException

stream 为 null。

ArgumentOutOfRangeException

mode 为无效值。

InvalidDataException

流的内容无法被解释为 zip 存档。

- 或 -

mode 是 Update，但存档中缺少项，或者项已损坏且无法读取。

- 或 -

mode 是 Update，但项太大，无法装入内存。

注解

如果 参数 mode 设置为 Read，则流必须支持读取。 如果 参数 mode 设置为 Create，则流必须支持写入。 如果 参数 mode 设置为 Update，则流必须支持读取、写入和查找。

打开 zip 存档文件进行读取并 entryNameEncoding 设置为 null时，将根据以下规则对条目名称进行解码：

• 如果未设置本地文件头) 的常规用途位标志中 (语言编码标志，则使用当前系统默认代码页来解码条目名称。

• 设置语言编码标志时，使用 UTF-8 解码条目名称。

打开 zip 存档文件进行读取并 entryNameEncoding 设置为 以外的 null值时，将根据以下规则对条目名称进行解码：

• 如果未设置语言编码标志，则使用指定的 entryNameEncoding 来解码条目名称。

• 设置语言编码标志时，使用 UTF-8 解码条目名称。

写入存档文件并将其 entryNameEncoding 设置为 null时，将根据以下规则对条目名称进行编码：

• 对于包含 ASCII 范围外字符的条目名称，设置语言编码标志，并使用 UTF-8 对条目名称进行编码。

• 对于仅包含 ASCII 字符的条目名称，不会设置语言编码标志，并且使用当前系统默认代码页对条目名称进行编码。

当写入存档文件并 entryNameEncoding 设置为 以外的 null值时，指定的 entryNameEncoding 用于将条目名称编码为字节。 仅当指定的编码 (为 UTF-8 编码时，才设置本地文件头) 的常规用途位标志中的语言编码标志。