语言

ZipArchive 构造函数

定义

初始化 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

包含要读取的存档的流。

例外

流已关闭或不支持读取。

stream 是 null。

流的内容不采用 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 存档是用于读取、创建还是更新条目。

例外

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

stream 是 null。

mode 是无效值。

无法将流的内容解释为 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

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

例外

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

stream 是 null。

mode 是无效值。

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

-或-

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

-或-

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

注解

如果参数 mode 设置为 Read,则流必须支持读取。 如果参数 mode 设置为 Create该参数,则流必须支持写入。 如果参数 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 存档工具和库的互作性时,才为此参数指定值。

例外

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

-或-

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

stream 是 null。

mode 是无效值。

无法将流的内容解释为 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 编码时,才会设置语言编码标志(在本地文件头的常规用途位标志中)。

适用于