ZipArchive 构造函数

定义

命名空间:: System.IO.Compression

程序集:: System.IO.Compression.dll

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

程序集:: netstandard.dll

重要

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

初始化 ZipArchive 类的新实例。

重载

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

ZipArchive(Stream)

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

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

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

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

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

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

如果释放对象后将流保持打开状态，则为。

例外

ArgumentException

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

ArgumentNullException

stream 是 null。

ArgumentOutOfRangeException

mode 是无效值。

InvalidDataException

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

-或-

mode 是 Update ，并且存档中缺少条目或已损坏，无法读取。

-或-

mode 是 Update ，条目太大，无法容纳到内存中。

注解

适用于

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

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);

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

如果释放对象后将流保持打开状态，则为。

entryNameEncoding: Encoding

在此存档中读取或写入条目名称和注释时要使用的编码。仅当需要编码才能与不支持条目名称或注释的 UTF-8 编码的 zip 存档工具和库的互作性时，才为此参数指定值。

例外

ArgumentException

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

-或-

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

ArgumentNullException

stream 是 null。

ArgumentOutOfRangeException

mode 是无效值。

InvalidDataException

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

-或-

mode 是 Update ，并且存档中缺少条目或已损坏，无法读取。

-或-

mode 是 Update ，条目太大，无法容纳到内存中。

注解

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

如果未设置语言编码标志（在本地文件头的常规用途位标志中），则当前系统默认代码页用于解码条目名称和注释。
设置语言编码标志时，UTF-8 用于解码条目名称和注释。

打开 zip 存档文件进行读取并 entryNameEncoding 设置为非 null值时，条目名称和注释将按照以下规则进行解码：

如果未设置语言编码标志，则指定 entryNameEncoding 用于解码条目名称和注释。
设置语言编码标志时，UTF-8 用于解码条目名称和注释。

写入存档文件并将其 entryNameEncoding 设置为 null时，条目名称和注释将按照以下规则进行编码：

对于包含 ASCII 范围之外的字符的条目名称和注释，将设置语言编码标志，并使用 UTF-8 对条目名称和注释进行编码。
对于仅包含 ASCII 字符的条目名称和注释，未设置语言编码标志，并且使用当前系统默认代码页对条目名称和注释进行编码。

写入存档文件并将其 entryNameEncoding 设置为其他 null值时，指定的 entryNameEncoding 值用于将条目名称和注释编码为字节。仅当指定的编码为 UTF-8 编码时，才会设置语言编码标志（在本地文件头的常规用途位标志中）。

适用于

反馈

此页面是否有帮助？