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 类的新实例。

public:
 ZipArchive(System::IO::Stream ^ stream);

public ZipArchive (System.IO.Stream stream);

new System.IO.Compression.ZipArchive : System.IO.Stream -> System.IO.Compression.ZipArchive

Public Sub New (stream As Stream)

参数

stream

Stream

包含待读取的存档的流。

例外

ArgumentException

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

ArgumentNullException

stream 为 null。

InvalidDataException

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

ZipArchive(Stream, ZipArchiveMode)

Source:

ZipArchive.cs

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

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

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

new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode -> System.IO.Compression.ZipArchive

Public Sub New (stream As Stream, mode As ZipArchiveMode)

参数

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 类的新实例，并选择性地使流保持打开状态。

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

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

new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode * bool -> System.IO.Compression.ZipArchive

Public Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean)

参数

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 类的新实例，使用项名的指定编码，并选择性地使流保持打开状态。

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

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

new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode * bool * System.Text.Encoding -> System.IO.Compression.ZipArchive

Public Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean, entryNameEncoding As Encoding)

参数

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 编码时，才设置本地文件头) 的常规用途位标志中的语言编码标志。