System.IO.Compression.ZipFile

提供创建、解压缩和打开 zip 存档的静态方法。

创建 zip 存档，该存档包含指定目录的文件和目录。

要存档的目录的路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 要生成的存档路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 or is , contains only white space, or contains at least one invalid character. or is null. In or , the specified path, file name, or both exceed the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. is invalid or does not exist (for example, it is on an unmapped drive). already exists.-or-A file in the specified directory could not be opened. specifies a directory.-or-The caller does not have the required permission to access the directory specified in or the file specified in . or contains an invalid format.-or-The zip archive does not support writing.

创建 zip 存档，该存档包括指定目录的文件和目录，使用指定压缩级别，以及可以选择包含基目录。

要存档的目录的路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 要生成的存档路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 指示创建项时是否强调速度或压缩有效性的枚举值之一。 包括从在存档的根的 的目录名称，则为 true；仅包含目录中的内容，则为 false。 or is , contains only white space, or contains at least one invalid character. or is null. In or , the specified path, file name, or both exceed the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. is invalid or does not exist (for example, it is on an unmapped drive). already exists.-or-A file in the specified directory could not be opened. specifies a directory.-or-The caller does not have the required permission to access the directory specified in or the file specified in . or contains an invalid format.-or-The zip archive does not support writing.

创建 zip 存档，该存档包括文件和指定目录的目录，使用指定压缩级别和条目名称的字符编码，以及可以选择包含基目录。

要存档的目录的路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 要生成的存档路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 指示创建项时是否强调速度或压缩有效性的枚举值之一。 包括从在存档的根的 的目录名称，则为 true；仅包含目录中的内容，则为 false。 在存档中读取或写入项名时使用的编码。仅当需要针对具有不支持项名的 UTF-8 编码的 zip 归档工具和库的互操作性进行编码时，为此参数指定一个值。 or is , contains only white space, or contains at least one invalid character.-or- is set to a Unicode encoding other than UTF-8. or is null. In or , the specified path, file name, or both exceed the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. is invalid or does not exist (for example, it is on an unmapped drive). already exists.-or-A file in the specified directory could not be opened. specifies a directory.-or-The caller does not have the required permission to access the directory specified in or the file specified in . or contains an invalid format.-or-The zip archive does not support writing.

将指定 zip 存档中的所有文件都解压缩到文件系统的一个目录下。

要解压缩存档的路径。 放置解压缩文件的目录的路径，指定为相对或绝对路径。相对路径是指相对于当前工作目录的路径。 or is , contains only white space, or contains at least one invalid character. or is null. The specified path in or exceeds the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. The specified path is invalid (for example, it is on an unmapped drive). The directory specified by already exists.-or-The name of an entry in the archive is , contains only white space, or contains at least one invalid character.-or-Extracting an archive entry would create a file that is outside the directory specified by .(For example, this might happen if the entry name contains parent directory accessors.)-or-An archive entry to extract has the same name as an entry that has already been extracted from the same archive. The caller does not have the required permission to access the archive or the destination directory. or contains an invalid format. was not found. The archive specified by is not a valid zip archive.-or-An archive entry was not found or was corrupt.-or-An archive entry was compressed by using a compression method that is not supported.

将指定 zip 存档中的所有文件解压缩到文件系统的一目录下，并使用项名称的指定字符编码。

要解压缩存档的路径。 放置解压缩文件的目录的路径，指定为相对或绝对路径。相对路径是指相对于当前工作目录的路径。 在存档中读取或写入项名时使用的编码。仅当需要针对具有不支持项名的 UTF-8 编码的 zip 归档工具和库的互操作性进行编码时，为此参数指定一个值。 or is , contains only white space, or contains at least one invalid character.-or- is set to a Unicode encoding other than UTF-8. or is null. The specified path in or exceeds the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. The specified path is invalid (for example, it is on an unmapped drive). The directory specified by already exists.-or-The name of an entry in the archive is , contains only white space, or contains at least one invalid character.-or-Extracting an archive entry would create a file that is outside the directory specified by .(For example, this might happen if the entry name contains parent directory accessors.)-or-An archive entry to extract has the same name as an entry that has already been extracted from the same archive. The caller does not have the required permission to access the archive or the destination directory. or contains an invalid format. was not found. The archive specified by is not a valid zip archive.-or-An archive entry was not found or was corrupt.-or-An archive entry was compressed by using a compression method that is not supported.

以指定的模式打开指定路径上的 zip 存档。

打开的 zip 存档。 要打开的存档的路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 指定允许对打开的存档中的项进行的操作的枚举值之一。 is , contains only white space, or contains at least one invalid character. is null. In , the specified path, file name, or both exceed the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. is invalid or does not exist (for example, it is on an unmapped drive). could not be opened.-or- is set to , but the file specified in already exists. specifies a directory.-or-The caller does not have the required permission to access the file specified in . specifies an invalid value. is set to , but the file specified in is not found. contains an invalid format. could not be interpreted as a zip archive.-or- is , but an entry is missing or corrupt and cannot be read.-or- is , but an entry is too large to fit into memory.

在指定模式下，在指定路径中，使用项名称的指定字符编码打开 zip 存档。

打开的 zip 存档。 要打开的存档的路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 指定允许对打开的存档中的项进行的操作的枚举值之一。 在存档中读取或写入项名时使用的编码。仅当需要针对具有不支持项名的 UTF-8 编码的 zip 归档工具和库的互操作性进行编码时，为此参数指定一个值。 is , contains only white space, or contains at least one invalid character.-or- is set to a Unicode encoding other than UTF-8. is null. In , the specified path, file name, or both exceed the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. is invalid or does not exist (for example, it is on an unmapped drive). could not be opened.-or- is set to , but the file specified in already exists. specifies a directory.-or-The caller does not have the required permission to access the file specified in . specifies an invalid value. is set to , but the file specified in is not found. contains an invalid format. could not be interpreted as a zip archive.-or- is , but an entry is missing or corrupt and cannot be read.-or- is , but an entry is too large to fit into memory.

打开在指定路径用于读取的 zip 存档。

打开的 zip 存档。 要打开的存档的路径，指定为相对路径或绝对路径。相对路径是指相对于当前工作目录的路径。 is , contains only white space, or contains at least one invalid character. is null. In , the specified path, file name, or both exceed the system-defined maximum length.For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. is invalid or does not exist (for example, it is on an unmapped drive). could not be opened. specifies a directory.-or-The caller does not have the required permission to access the file specified in . The file specified in is not found. contains an invalid format. could not be interpreted as a zip archive.

为 和 类提供扩展方法。

通过压缩并将其添加到邮编存档的存档文件。

zip 存档中新项的包装。 要添加该文件的 zip 存档。 待存档的文件的路径。可以指定相对或绝对路径。相对路径被解释为相对于当前工作目录。 要在 zip 存档中生成的输入的名称。 为 ，仅包含空白，或包含至少一个无效字符。- 或 - 为 。 或 为 null。 在内，指定的路径、文件名或者两者都超出了系统定义的最大长度。例如，在基于 Windows 的平台上，路径不得超过 248 个字符，文件名不得超过 260 个字符。 无效（例如，在未映射的驱动器上）。 无法打开由 指定的文件。 指定目录。- 或 -调用方没有访问 指定的文件的权限。 未找到 指定的文件。 参数的格式无效。- 或 -zip 归档不支持写入。 zip 存档已释放。

通过使用指定压缩级别压缩并将其添加到邮编存档的存档文件。

zip 存档中新项的包装。 要添加该文件的 zip 存档。 待存档的文件的路径。可以指定相对或绝对路径。相对路径被解释为相对于当前工作目录。 要在 zip 存档中生成的输入的名称。 创建项时，指示是否要强调速度或压缩有效性的枚举值之一。 为 ，仅包含空白，或包含至少一个无效字符。- 或 - 为 。 或 为 null。 无效（例如，在未映射的驱动器上）。 在内，指定的路径、文件名或者两者都超出了系统定义的最大长度。例如，在基于 Windows 的平台上，路径不得超过 248 个字符，文件名不得超过 260 个字符。 无法打开由 指定的文件。 指定目录。- 或 -调用方没有访问 指定的文件的权限。 未找到 指定的文件。 参数的格式无效。- 或 -zip 归档不支持写入。 zip 存档已释放。

将 zip 存档中的所有文件都解压到文件系统的一目录下。

从 zip 归档解压文件。 到放置解压缩文件的目录的路径。可以指定相对或绝对路径。相对路径被解释为相对于当前工作目录。 为 ，仅包含空白，或包含至少一个无效字符。 为 null。 指定路径超过了系统定义的最大长度。例如，在基于 Windows 的平台上，路径不得超过 248 个字符，文件名不得超过 260 个字符。 指定的路径无效（例如，它位于未映射的驱动器上）。 指定的目录已存在。- 或 -一个在存档中的输入名称是 ，仅包含空白或包含至少一个无效字符。- 或 -从存档中提取条目将生成在 指定的目录之外的一个文件。（例如，如果该输入名称包括父目录访问器，则这可能发生。）- 或 -存档中具有相同名称的两个或多个项。 调用方不具有所需权限以便写入到目标目录。 包含无效格式。 未能找到归档项或已损坏。- 或 -通过一种不支持的压缩方法，对一个存档条目进行压缩。

将 zip 存档中的条目解压到文件下。

从 zip 归档项解压文件。 从输入的内容生成的文件的路径。可以指定相对或绝对路径。相对路径被解释为相对于当前工作目录。 是一个零长度字符串，仅包含空白或者包含一个或多个由 定义的无效字符。- 或 - 指定目录。 为 null。 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如，在基于 Windows 的平台上，路径不得超过 248 个字符，文件名不得超过 260 个字符。 指定的路径无效（例如，它位于未映射的驱动器上）。 已存在。- 或 -发生了 I/O 错误。- 或 -该项当前为编写开放。- 或 -已从存档中删除的项。 调用方没有创建新文件所需的权限。 该输入从存档中缺失，或损坏且无法读取。- 或 -该输入已经通过使用一种不被支持的压缩方法压缩。 已释放属于 zip 归档项。 的格式无效。- 或 -该 zip 归档项在 模式中打开的，不允许项检索。

将 zip 存档中的条目解压到文件下，并可选择覆盖具有相同名称的现存文件。

从 zip 归档项解压文件。 从输入的内容生成的文件的路径。可以指定相对或绝对路径。相对路径被解释为相对于当前工作目录。 如果覆盖带与目标文件同名的名称的现有文件，则为 true；否则为 false。 是一个零长度字符串，仅包含空白或者包含一个或多个由 定义的无效字符。- 或 - 指定目录。 为 null。 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如，在基于 Windows 的平台上，路径不得超过 248 个字符，文件名不得超过 260 个字符。 指定的路径无效（例如，它位于未映射的驱动器上）。 已存在，且 是 false。- 或 -发生了 I/O 错误。- 或 -该项当前为编写开放。- 或 -已从存档中删除的项。 调用方没有创建新文件所需的权限。 该输入从存档中缺失或损坏且无法读取。- 或 -该输入已经通过使用一种不被支持的压缩方法压缩。 已释放属于 zip 归档项。 的格式无效。- 或 -该 zip 归档项在 模式中打开的，不允许项检索。