此方法创建指定的目录和所有子目录。 目标目录不能已经存在。 与验证 或 sourceArchiveFileName 参数中的 destinationDirectoryName 路径相关的异常在提取之前引发。 否则，如果在提取过程中发生错误，存档将保持部分提取状态。 每个提取的文件都具有指定的 destinationDirectoryName 目录的相对路径，因为它的源条目对存档的根目录具有相同的路径。

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : string * string * bool -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)

ZipArchiveEntry 的名称的长度为零，仅包含空格，或包含一个或多个由 InvalidPathChars 定义的无效字符。

- 或 -

提取 ZipArchiveEntry 将导致文件目标位于目标目录之外（例如，由于父目录访问器）。

- 或 -

与 ZipArchiveEntry 已提取的同一存档中的条目同名。

如果在提取存档时出错，存档将保持部分提取状态。

将提取每个条目，以便提取的文件具有与存档项相同的相对路径 destinationDirectoryName 。

sourceArchiveFileName 和 destinationDirectoryName 参数接受相对路径和绝对路径。 相对路径被解释为相对于当前工作目录。

如果要存档的文件的上次修改时间无效，则将使用 1980 年 1 月 1 日午夜 (zip 时间戳格式表示的第一个日期和时间) 。

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding);

public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding);

public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding);

static member ExtractToDirectory : string * string * System.Text.Encoding -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding)

destinationDirectoryName 或 sourceArchiveFileName 是 Empty ，仅包含空格，或包含至少一个无效字符。

- 或 -

entryNameEncoding 设置为不同于 UTF-8 的 Unicode 编码。

一个在存档中的输入名称是 Empty ，仅包含空白或包含至少一个无效字符。

- 或 -

提取存档条目将生成在 destinationDirectoryName 指定的目录之外的一个文件。 （例如，如果该输入名称包括父目录访问器，则这可能发生。）

- 或 -

要提取的存档项与已提取或存在于 中的 destinationDirectoryName 条目同名。

如有必要，此方法会创建指定的目录和所有子目录。 与验证 或 sourceArchiveFileName 参数中的 destinationDirectoryName 路径相关的异常在提取之前引发。 否则，如果在提取过程中发生错误，存档将保持部分提取状态。 每个提取的文件都具有指定的 destinationDirectoryName 目录的相对路径，因为它的源条目对存档的根目录具有相同的路径。

如果 entryNameEncoding 设置为以外的 null 值，则根据以下规则对条目名称进行解码：

如果 entryNameEncoding 设置为 null ，则根据以下规则解码条目名称：

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding, bool overwriteFiles);

public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles);

public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding, bool overwriteFiles);

static member ExtractToDirectory : string * string * System.Text.Encoding * bool -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean)

sourceArchiveFileName 或 destinationDirectoryName 是一个长度为零的字符串，仅包含空格，或包含一个或多个由 InvalidPathChars 定义的无效字符。

- 或 -

entryNameEncoding 设置为不同于 UTF-8 的 Unicode 编码。

ZipArchiveEntry 的名称的长度为零，仅包含空格，或包含一个或多个由 InvalidPathChars 定义的无效字符。

- 或 -

提取 ZipArchiveEntry 将导致文件目标位于目标目录之外（例如，由于父目录访问器）。

- 或 -

ZipArchiveEntry 与一个已从同一存档中解压缩的项同名。

如果在提取存档时出错，存档将保持部分提取状态。

将提取每个条目，以便提取的文件具有与条目到存档的相同相对路径 destinationDirectoryName 。

sourceArchiveFileName 和 destinationDirectoryName 参数接受相对路径和绝对路径。 相对路径被解释为相对于当前工作目录。

如果要存档的文件的上次修改时间无效，则将使用 1980 年 1 月 1 日午夜 (zip 时间戳格式表示的第一个日期和时间，) 。