Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.2.0)
This class represents Z (compress) archive file. Use it to compose or extract Z archives.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive, IDisposable, IArchiveFileEntry
Inherited Members
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
See https://docs.fileformat.com/compression/z/
Constructors
ZArchive()
Initializes a new instance of the Aspose.Zip.Z.ZArchive class prepared for compressing.
public ZArchive()ZArchive(Stream, ZArchiveLoadOptions)
Initializes a new instance of the Aspose.Zip.Z.ZArchive class prepared for decompressing.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Parameters
source Stream
The source of the archive.
loadOptions ZArchiveLoadOptions
The options to load archive with.
Remarks
This constructor does not decompress. See Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) method for decompressing.
Exceptions
source is not seekable.
source is null.
ZArchive(string, ZArchiveLoadOptions)
Initializes a new instance of the Aspose.Zip.Z.ZArchive class prepared for decompressing.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Parameters
path string
Path to the source of the archive.
loadOptions ZArchiveLoadOptions
The options to load archive with.
Remarks
This constructor does not decompress. See Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) method for decompressing.
Exceptions
path is null.
The caller does not have the required permission to access.
The path is empty, contains only white spaces, or contains invalid characters.
Access to file path is denied.
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.
File at path contains a colon (:) in the middle of the string.
The file is not found.
The specified path is invalid, such as being on an unmapped drive.
The file is already open.
Methods
Dispose()
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
public void Dispose()Dispose(bool)
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Whether managed resources should be disposed.
Extract(Stream)
Extracts Z archive to a stream.
public void Extract(Stream destination)Parameters
destination Stream
Stream for storing decompressed data.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}Exceptions
Data can not be decompressed.
Extract(FileInfo)
Extracts Z archive to a file.
public void Extract(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo for storing decompressed data.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Exceptions
The caller does not have the required permission to open the fileInfo.
File path is empty or contains only white spaces.
The file is not found.
Path to file is read-only or is a directory.
fileInfo is null.
The specified path is invalid, such as being on an unmapped drive.
The file is already open.
Data can not be decompressed.
Extract(string)
Extracts Z archive to a file by path.
public FileInfo Extract(string path)Parameters
path string
Path to file which will store decompressed data.
Returns
Info of extracted file.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}Exceptions
path is null.
The caller does not have the required permission to access.
The path is empty, contains only white spaces, or contains invalid characters.
Access to file path is denied.
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.
File at path contains a colon (:) in the middle of the string.
Data can not be decompressed.
ExtractToDirectory(string)
Extracts content of the archive to the directory provided.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
The path to the directory to place the extracted files in.
Remarks
If the directory does not exist, it will be created.
Exceptions
destinationDirectory is null.
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 caller does not have the required permission to access existing directory.
If directory does not exist, path contains a colon character (:) that is not part of a drive label (“C:").
destinationDirectory is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.
-or- path is prefixed with, or contains, only a colon character (:).
The directory specified by path is a file. -or- The network name is not known.
Save(Stream, ZArchiveSaveOptions)
Saves xz archive to the stream provided.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Parameters
output Stream
Destination stream.
settings ZArchiveSaveOptions
Optional settings for archive composition.
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Remarks
output must be seekable.
Exceptions
output does not support seeking.
output is null.
Save(string, ZArchiveSaveOptions)
Saves Z archive to destination file provided.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Parameters
destinationFileName string
+The path of the archive to be created. If the specified file name points to an existing file, it will be overwritten.
settings ZArchiveSaveOptions
Optional settings for archive composition.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
destinationFileName is null.
The caller does not have the required permission to access.
The destinationFileName is empty, contains only white spaces, or contains invalid characters.
Access to file destinationFileName is denied.
The specified destinationFileName, 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.
File at destinationFileName contains a colon (:) in the middle of the string.
SetSource(Stream)
Sets the content to be compressed within the archive.
public void SetSource(Stream source)Parameters
source Stream
The input stream for the archive.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}SetSource(FileInfo)
Sets the content to be compressed within the archive.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo which will be opened as input stream.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
The caller does not have the required permission to open the fileInfo.
File path is empty or contains only white spaces.
The file is not found.
Path to file is read-only or is a directory.
fileInfo is null.
The specified path is invalid, such as being on an unmapped drive.
The file is already open.
SetSource(string)
Sets the content to be compressed within the archive.
public void SetSource(string sourcePath)Parameters
sourcePath string
Path to file which will be opened as input stream.
Examples
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Exceptions
sourcePath is null or empty string.
The caller does not have the required permission to access a resource.
The sourcePath is empty, contains only white spaces, or contains invalid characters.
Access to file sourcePath is denied.
The specified sourcePath, 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.
File at sourcePath contains a colon (:) in the middle of the string.
