System.IO.Compression.ZipFile

Provides static methods for creating, extracting, and opening zip archives.

Creates a zip archive in the specified stream that contains the files and directories from the specified directory, uses the specified compression level and character encoding for entry names and comments, and optionally includes the base directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The stream where the zip archive is to be stored. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. to include the directory name from at the root of the archive; to include only the contents of the directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. is , contains only white space, or contains at least one invalid character. -or- The stream does not support writing. or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). A file in the specified directory could not be opened. -or- An I/O error occurred while opening a file to be archived. contains an invalid format. is not a valid value.

Creates a zip archive in the specified stream that contains the files and directories from the specified directory, uses the specified compression level, and optionally includes the base directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The stream where the zip archive is to be stored. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. to include the directory name from at the root of the archive; to include only the contents of the directory. is , contains only white space, or contains at least one invalid character. -or- The stream does not support writing. or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). A file in the specified directory could not be opened. -or- An I/O error occurred while opening a file to be archived. contains an invalid format. is not a valid value.

Creates a zip archive in the specified stream that contains the files and directories from the specified directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The stream where the zip archive is to be stored. is , contains only white space, or contains at least one invalid character. -or- The stream does not support writing. or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). A file in the specified directory could not be opened. -or- An I/O error occurred while opening a file to be archived. contains an invalid format.

Creates a zip archive that contains the files and directories from the specified directory, uses the specified compression level and character encoding for entry names and comments, and optionally includes the base directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The path of the archive to be created, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. to include the directory name from at the root of the archive; to include only the contents of the directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. 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 . In or , the specified path, file name, or both exceed the system-defined maximum length. 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. -or- An I/O error occurred while opening a file to be archived. 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.

Creates a zip archive that contains the files and directories from the specified directory, uses the specified compression level, and optionally includes the base directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The path of the archive to be created, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. to include the directory name from at the root of the archive; to include only the contents of the directory. or is , contains only white space, or contains at least one invalid character. or is . In or , the specified path, file name, or both exceed the system-defined maximum length. 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. -or- An I/O error occurred while opening a file to be archived. 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.

Creates a zip archive that contains the files and directories from the specified directory.

Asynchronously creates a zip archive in the specified stream that contains the files and directories from the specified directory, using the specified compression level and character encoding for entry names, and optionally including the base directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The stream where the zip archive is to be stored. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. to include the directory name from at the root of the archive; to include only the contents of the directory. The encoding to use when reading or writing entry names in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. The cancellation token to monitor for cancellation requests. is , contains only white space, or contains at least one invalid character. -or- The stream does not support writing. or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). A file in the specified directory could not be opened. -or- An I/O error occurred while opening a file to be archived. contains an invalid format. is not a valid value. An asynchronous operation is cancelled.

Asynchronously creates a zip archive in the specified stream that contains the files and directories from the specified directory, using the specified compression level, and optionally including the base directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The stream where the zip archive is to be stored. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. to include the directory name from at the root of the archive; to include only the contents of the directory. The token to monitor for cancellation requests. is , contains only white space, or contains at least one invalid character. -or- The stream does not support writing. or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). A file in the specified directory could not be opened. -or- An I/O error occurred while opening a file to be archived. contains an invalid format. is not a valid value. An asynchronous operation is cancelled.

Asynchronously creates a zip archive in the specified stream that contains the files and directories from the specified directory.

The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The stream where the zip archive is to be stored. The cancellation token to monitor for cancellation requests. is , contains only white space, or contains at least one invalid character. -or- The stream does not support writing. or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). A file in the specified directory could not be opened. -or- An I/O error occurred while opening a file to be archived. contains an invalid format. An asynchronous operation is cancelled.

Asynchronously creates a zip archive at the path that contains the files and directories in the directory specified by .

The path to the directory on the file system to be archived. The name of the archive to be created. One of the enumeration values that specifies the level of the compression (speed/memory vs. compressed size trade-off). to indicate that a directory named should be included at the root of the archive. to indicate that the files and directories in should be included directly in the archive. The encoding to use when reading or writing entry names and comments in this ZipArchive. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . In or , the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified in or is invalid, (for example, it is on an unmapped drive). -or- The directory specified by does not exist. already exists. -or- An I/O error occurred while opening a file to be archived. specified a directory. -or- The caller does not have the required permission. or is in an invalid format. An asynchronous operation is cancelled.

Asynchronously creates a zip archive at the path that contains the files and directories in the directory specified by .

The path to the directory on the file system to be archived. The name of the archive to be created. One of the enumeration values that specifies the level of the compression (speed/memory vs. compressed size trade-off). to indicate that a directory named should be included at the root of the archive. to indicate that the files and directories in should be included directly in the archive. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . In or , the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified in or is invalid, (for example, it is on an unmapped drive). -or- The directory specified by does not exist. already exists. -or- An I/O error occurred while opening a file to be archived. specified a directory. -or- The caller does not have the required permission. or is in an invalid format. An asynchronous operation is cancelled.

Asynchronously creates a zip archive at the path that contains the files and directories from the directory specified by .

The path to the directory on the file system to be archived. The name of the archive to be created. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . In or , the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified in or is invalid, (for example, it is on an unmapped drive). -or- The directory specified by does not exist. already exists. -or- An I/O error occurred while opening a file to be archived. specified a directory. -or- The caller does not have the required permission. or is in an invalid format. An asynchronous operation is cancelled.

Extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system, and optionally allows choosing if the files in the destination directory should be overwritten.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. to overwrite files; otherwise. is , contains only white space, or contains at least one invalid character. or is . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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- is and an archive entry to extract has the same name as an entry that has already been extracted or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported.

Extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system, uses the specified character encoding for entry names and comments, and optionally allows choosing if the files in the destination directory should be overwritten.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. to overwrite files; otherwise. 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 . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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- is and an archive entry to extract has the same name as an entry that has already been extracted or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported.

Extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system and uses the specified character encoding for entry names and comments.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. 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 . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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 or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported.

Extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. is , contains only white space, or contains at least one invalid character. or is . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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 or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported.

Extracts all of the files in the specified archive to a directory on the file system.

The path on the file system to the archive that is to be extracted. The path to the destination directory on the file system. to overwrite files; otherwise. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by . or is . or specifies a path, a file name, or both that exceed the system-defined maximum length. The path specified by or is invalid (for example, it is on an unmapped drive). is and already contains a file with the same name as a file that's being extracted. -or- An I/O error has occurred. -or- The name of a is zero-length, contains only whitespace, or contains one or more invalid characters as defined by . -or- Extracting a would result in a file destination that is outside the destination directory (for example, because of parent directory accessors). -or- A has the same name as an entry from the same archive that's already been extracted. The caller does not have the required permission. or is in an invalid format. was not found. The archive specified by is not a valid . -or- A was not found or was corrupt. -or- A has been compressed using a compression method that isn't supported.

Extracts all of the files in the specified archive to a directory on the file system.

The path on the file system to the archive that is to be extracted. The path to the destination directory on the file system. The encoding to use when reading entry names and comments in this . to overwrite files; otherwise. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by . -or- is set to a Unicode encoding other than UTF-8. or is . or specifies a path, a file name, or both that exceed the system-defined maximum length. The path specified by or is invalid (for example, it is on an unmapped drive). is and an archive entry to extract has the same name as a file that already exists in . -or- An I/O error has occurred. -or- The name of a is zero-length, contains only whitespace, or contains one or more invalid characters as defined by . -or- Extracting a would result in a file destination that is outside the destination directory (for example, because of parent directory accessors). -or- A has the same name as an already extracted entry from the same archive. The caller does not have the required permission. or is in an invalid format. was not found. The archive specified by is not a valid . -or- An archive entry was not found or was corrupt. -or- An archive entry has been compressed using a compression method that isn't supported.

Extracts all the files in the specified zip archive to a directory on the file system and uses the specified character encoding for entry names and comments.

The path to the archive that is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. 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 . The specified path in or exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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 or that exists in . 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 isn't supported.

Extracts all the files in the specified zip archive to a directory on the file system.

The path to the archive that is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. or is , contains only white space, or contains at least one invalid character. or is . The specified path in or exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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 or that exists in . 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 isn't supported.

Asynchronously extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system, and optionally allows choosing if the files in the destination directory should be overwritten.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. to overwrite files; otherwise. The cancellation token to monitor for cancellation requests. is , contains only white space, or contains at least one invalid character. or is . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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- is and an archive entry to extract has the same name as an entry that has already been extracted or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system, uses the specified character encoding for entry names, and optionally allows choosing if the files in the destination directory should be overwritten.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. to overwrite files; otherwise. The cancellation token to monitor for cancellation requests. 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 . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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- is and an archive entry to extract has the same name as an entry that has already been extracted or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system and uses the specified character encoding for entry names.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. The cancellation token to monitor for cancellation requests. 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 . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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 or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all the files from the zip archive stored in the specified stream and places them in the specified destination directory on the file system.

The stream from which the zip archive is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The cancellation token to monitor for cancellation requests. is , contains only white space, or contains at least one invalid character. or is . The specified path in exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). 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 or that exists in . The caller does not have the required permission to access the archive or the destination directory. contains an invalid format. The archive contained in the stream 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 isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all of the files in the specified archive to a directory on the file system.

The path to the archive on the file system that is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. to overwrite files; otherwise. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . or specifies a path, file name, or both that exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified by or is invalid, (for example, it is on an unmapped drive). An I/O error has occurred. -or- An archive entry's name is zero-length, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- Extracting an archive entry would result in a file destination that is outside the destination directory (for example, because of parent directory accessors). -or- An archive entry has the same name as an already extracted entry from the same archive. The caller does not have the required permission. or is in an invalid format. was not found. not a valid ZipArchive. -or- An archive entry was not found or was corrupt. -or- An archive entry has been compressed using a compression method that isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all of the files in the specified archive to a directory on the file system. The specified directory must not exist. This method will create all subdirectories and the specified directory. If there is an error while extracting the archive, the archive will remain partially extracted. Each entry will be extracted such that the extracted file has the same relative path to the destinationDirectoryName as the entry has to the archive. The path is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. If a file to be archived has an invalid last modified time, the first datetime representable in the zip timestamp format (midnight on January 1, 1980) will be used.

The path to the archive on the file system that is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The encoding to use when reading or writing entry names and comments in this ZipArchive. to overwrite files; otherwise. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . or specifies a path, file name, or both that exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified by or is invalid, (for example, it is on an unmapped drive). An I/O error has occurred. -or- An archive entry's name is zero-length, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- Extracting an archive entry would result in a file destination that is outside the destination directory (for example, because of parent directory accessors). -or- An archive entry has the same name as an already extracted entry from the same archive. The caller does not have the required permission. or is in an invalid format. was not found. The archive specified by is not a valid ZipArchive. -or- An archive entry was not found or was corrupt. -or- An archive entry has been compressed using a compression method that isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all of the files in the specified archive to a directory on the file system.

The path to the archive on the file system that is to be extracted. The path to the directory on the file system. The directory specified must not exist, but the directory that it is contained in must exist. The encoding to use when reading or writing entry names and comments in this ZipArchive. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . or specifies a path, file name, or both that exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified by or is invalid, (for example, it is on an unmapped drive). An I/O error has occurred. -or- An archive entry's name is zero-length, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- Extracting an archive entry would result in a file destination that is outside the destination directory (for example, because of parent directory accessors). -or- An archive entry has the same name as an already extracted entry from the same archive. The caller does not have the required permission. or is in an invalid format. was not found. The archive specified by is not a valid ZipArchive. -or- An archive entry was not found or was corrupt. -or- An archive entry has been compressed using a compression method that isn't supported. An asynchronous operation is cancelled.

Asynchronously extracts all of the files in the specified archive to a directory on the file system.

The path to the archive on the file system that is to be extracted. The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. The cancellation token to monitor for cancellation requests. or is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. or is . or specifies a path, file name, or both that exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified by or is invalid, (for example, it is on an unmapped drive). An I/O error has occurred. -or- An archive entry's name is zero-length, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- Extracting an archive entry would result in a file destination that is outside the destination directory (for example, because of parent directory accessors). -or- An archive entry has the same name as an already extracted entry from the same archive. The caller does not have the required permission. or is in an invalid format. was not found. The archive specified by is not a valid ZipArchive. -or- An archive entry was not found or was corrupt. -or- An archive entry has been compressed using a compression method that isn't supported. An asynchronous operation is cancelled.

Opens a zip archive at the specified path, in the specified mode, and by using the specified character encoding for entry names and comments.

The path to the archive to open, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. One of the enumeration values that specifies the actions that are allowed on the entries in the opened archive. The encoding to use when reading or writing entry names and comments in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names or comments. is , contains only white space, or contains at least one invalid character. -or- is set to a Unicode encoding other than UTF-8. is . In , the specified path, file name, or both exceed the system-defined maximum length. 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. -or- An unspecified I/O error occurred while opening the file. 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. The opened zip archive.

Opens a zip archive at the specified path and in the specified mode.

The path to the archive to open, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. One of the enumeration values that specifies the actions that are allowed on the entries in the opened archive. is , contains only white space, or contains at least one invalid character. is . In , the specified path, file name, or both exceed the system-defined maximum length. 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. -or- An unspecified I/O error occurred while opening the file. 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. The opened zip archive.

Asynchronously opens a ZipArchive on the specified in the specified ZipArchiveMode mode.

The path on the filesystem to open the archive on. One of the enumeration values that specifies the actions that are allowed on the entries in the opened archive. The encoding to use when reading or writing entry names and comments in this ZipArchive. The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. is . exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. is invalid, (for example, it is on an unmapped drive). An unspecified I/O error occurred while opening the file. specified a directory. -or- The caller does not have the required permission. specified an invalid value. The file specified in was not found. is in an invalid format. The specified file could not be interpreted as a zip file. -or- is and an entry is missing from the archive or is corrupt and cannot be read. -or- is and an entry is too large to fit into memory. An asynchronous operation is cancelled.

Asynchronously opens a ZipArchive on the specified in the specified ZipArchiveMode mode.

The path on the filesystem to open the archive on. One of the enumeration values that specifies the actions that are allowed on the entries in the opened archive. The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. is . exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified is invalid, (for example, it is on an unmapped drive). An unspecified I/O error occurred while opening the file. specified a directory. -or- The caller does not have the required permission. specified an invalid value. The file specified in was not found. is in an invalid format. The specified file could not be interpreted as a zip file. -or- is and an entry is missing from the archive or is corrupt and cannot be read. -or- is and an entry is too large to fit into memory. An asynchronous operation is cancelled.

Opens a zip archive for reading at the specified path.

The path to the archive to open, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory. is , contains only white space, or contains at least one invalid character. is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid or does not exist (for example, it is on an unmapped drive). could not be opened. -or- An unspecified I/O error occurred while opening the file. 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. The opened zip archive.

Asynchronously opens a ZipArchive on the specified path for reading. The specified file is opened with FileMode.Open.

A string specifying the path on the filesystem to open the archive on. The path is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. archiveFileName is . The specified archiveFileName exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified archiveFileName is invalid, (for example, it is on an unmapped drive). An unspecified I/O error occurred while opening the file. specified a directory. -or- The caller does not have the required permission. The file specified in archiveFileName was not found. archiveFileName is in an invalid format. The specified file could not be interpreted as a zip file. An asynchronous operation is cancelled.

Provides extension methods for the and classes.

Archives a file by compressing it using the specified compression level and adding it to the zip archive.

The zip archive to add the file to. The path to the file to be archived. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. The name of the entry to create in the zip archive. One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry. is , contains only white space, or contains at least one invalid character. -or- is . or is . is invalid (for example, it is on an unmapped drive). In , the specified path, file name, or both exceed the system-defined maximum length. The file specified by cannot be opened, or is too large to be updated (current limit is Int32.MaxValue. specifies a directory. -or- The caller does not have the required permission to access the file specified by . The file specified by is not found. The parameter is in an invalid format. -or- The zip archive does not support writing. The zip archive has been disposed. A wrapper for the new entry in the zip archive.

Archives a file by compressing it and adding it to the zip archive.

The zip archive to add the file to. The path to the file to be archived. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. The name of the entry to create in the zip archive. is , contains only white space, or contains at least one invalid character. -or- is . or is . In , the specified path, file name, or both exceed the system-defined maximum length. is invalid (for example, it is on an unmapped drive). The file specified by cannot be opened, or is too large to be updated (current limit is Int32.MaxValue. specifies a directory. -or- The caller does not have the required permission to access the file specified by . The file specified by is not found. The parameter is in an invalid format. -or- The zip archive does not support writing. The zip archive has been disposed. A wrapper for the new entry in the zip archive.

Asynchronously adds a file from the file system to the archive under the specified entry name.

The zip archive to add the file to. The path to the file on the file system to be copied from. The path is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. The name of the entry to be created. The level of the compression (speed/memory vs. compressed size trade-off). The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- is a zero-length string. or is . In , the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified is invalid, (for example, it is on an unmapped drive). An I/O error occurred while opening the file specified by . specified a directory. -or- The caller does not have the required permission. The file specified in was not found. is in an invalid format or the ZipArchive does not support writing. The ZipArchive has already been closed. An asynchronous operation is cancelled. A wrapper for the newly created entry.

Asynchronously adds a file from the file system to the archive under the specified entry name.

The zip archive to add the file to. The path to the file on the file system to be copied from. The path is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. The name of the entry to be created. The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- is a zero-length string. or is . In , the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified is invalid, (for example, it is on an unmapped drive). An I/O error occurred while opening the file specified by . specified a directory. -or- The caller does not have the required permission. The file specified in was not found. is in an invalid format or the ZipArchive does not support writing. The ZipArchive has already been closed. An asynchronous operation is cancelled. A wrapper for the newly created entry.

Extracts all of the files in the archive to a directory on the file system.

The to extract. The path to the destination directory on the file system. The path can be relative or absolute. A relative path is interpreted as relative to the current working directory. to overwrite existing files; otherwise. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by . is . The specified path, file name, or both exceed the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). The name of a is zero-length, contains only whitespace, or contains one or more invalid characters as defined by . -or- Extracting a would have resulted in a destination file that is outside (for example, if the entry name contains parent directory accessors). -or- A has the same name as an already extracted entry from the same archive. The caller does not have the required permission. is in an invalid format. A was not found or was corrupt. -or- A has been compressed using a compression method that is not supported.

Extracts all the files in the zip archive to a directory on the file system.

The zip archive to extract files from. The path to the directory to place the extracted files in. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. is , contains only white space, or contains at least one invalid character. is . The specified path exceeds the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). The name of an entry in the archive is , contains only white space, or contains at least one invalid character. -or- Extracting an entry from the archive 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- Two or more entries in the archive have the same name. The caller does not have the required permission to write to the destination directory. contains an invalid format. An archive entry cannot be found or is corrupt. -or- An archive entry was compressed by using a compression method that is not supported.

Extracts all of the files in the archive to a directory on the file system. The specified directory may already exist.

The zip archive to extract files from. The path to the directory on the file system. to overwrite files; otherwise. The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. This method will create all subdirectories and the specified directory if necessary. If there is an error while extracting the archive, the archive will remain partially extracted. Each entry is extracted such that the extracted file has the same relative path to as the entry has to the root of the archive. If a file to be archived has an invalid last modified time, the first datetime representable in the Zip timestamp format (midnight on January 1, 1980) will be used. is . The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified path is invalid, (for example, it is on an unmapped drive). An archive entry's name is zero-length, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- Extracting an archive entry would have resulted in a destination file that is outside (for example, if the entry name contains parent directory accessors). -or- An archive entry has the same name as an already extracted entry from the same archive. The caller does not have the required permission. is in an invalid format. An archive entry was not found or was corrupt. -or- An archive entry has been compressed using a compression method that is not supported.

Asynchronously extracts all of the files in the archive to a directory on the file system. The specified directory can already exist.

The zip archive to extract files from. The path to the directory on the file system. The cancellation token to monitor for cancellation requests. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. is . The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified path is invalid, (for example, it is on an unmapped drive). An archive entry's name is zero-length, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- Extracting an archive entry would have resulted in a destination file that is outside (for example, if the entry name contains parent directory accessors). -or- An archive entry has the same name as an already extracted entry from the same archive. The caller does not have the required permission. is in an invalid format. An archive entry was not found or is corrupt. -or- An archive entry has been compressed using a compression method that is not supported. An asynchronous operation is cancelled.

Extracts an entry in the zip archive to a file, and optionally overwrites an existing file that has the same name.

The zip archive entry to extract a file from. The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. to overwrite an existing file that has the same name as the destination file; otherwise, . is a zero-length string, contains only white space, or contains one or more invalid characters as defined by . -or- specifies a directory. is . The specified path, file name, or both exceed the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). already exists and is . -or- An I/O error occurred. -or- The entry is currently open for writing. -or- The entry has been deleted from the archive. The caller does not have the required permission to create the new file. The entry is missing from the archive or is corrupt and cannot be read. -or- The entry has been compressed by using a compression method that is not supported. The zip archive that this entry belongs to has been disposed. is in an invalid format. -or- The zip archive for this entry was opened in mode, which does not permit the retrieval of entries.

Extracts an entry in the zip archive to a file.

The zip archive entry to extract a file from. The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory. is a zero-length string, contains only white space, or contains one or more invalid characters as defined by . -or- specifies a directory. is . The specified path, file name, or both exceed the system-defined maximum length. The specified path is invalid (for example, it is on an unmapped drive). already exists. -or- An I/O error occurred. -or- The entry is currently open for writing. -or- The entry has been deleted from the archive. The caller does not have the required permission to create the new file. The entry is missing from the archive, or is corrupt and cannot be read. -or- The entry has been compressed by using a compression method that is not supported. The zip archive that this entry belongs to has been disposed. is in an invalid format. -or- The zip archive for this entry was opened in mode, which does not permit the retrieval of entries.

Asynchronously creates a file on the file system with the entry's contents and the specified name.

The zip archive entry to extract a file from. The name of the file that will hold the contents of the entry. to overwrite files; otherwise. The cancellation token to monitor for cancellation requests. The caller does not have the required permission. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- specifies a directory. is . The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified in is invalid (for example, it is on an unmapped drive). An I/O error has occurred. -or- The entry is currently open for writing. -or- The entry has been deleted from the archive. is in an invalid format. -or- The ZipArchive that this entry belongs to was opened in a write-only mode. The entry is missing from the archive or is corrupt and cannot be read. -or- The entry has been compressed using a compression method that is not supported. The ZipArchive that this entry belongs to has been disposed. An asynchronous operation is cancelled.

Asynchronously creates a file on the file system with the entry's contents and the specified name.

The zip archive entry to extract a file from. The name of the file that will hold the contents of the entry. The cancellation token to monitor for cancellation requests. The caller does not have the required permission. is a zero-length string, contains only whitespace, or contains one or more invalid characters as defined by InvalidPathChars. -or- specifies a directory. is . The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The path specified in is invalid (for example, it is on an unmapped drive). An I/O error has occurred. -or- The entry is currently open for writing. -or- The entry has been deleted from the archive. is in an invalid format. -or- The ZipArchive that this entry belongs to was opened in a write-only mode. The entry is missing from the archive or is corrupt and cannot be read. -or- The entry has been compressed using a compression method that is not supported. The ZipArchive that this entry belongs to has been disposed.