Archive.Archive

Archive(ArchiveEntrySettings)

Initializes a new instance of the Archive class with optional settings for its entries.

public Archive(ArchiveEntrySettings newEntrySettings = null)

Parameter	Type	Description
newEntrySettings	ArchiveEntrySettings	Compression and encryption settings used for newly added ArchiveEntry items. If not specified, the most common Deflate compression without encryption would be used.

Examples

The following example shows how to compress a single file with default settings.

using (FileStream zipFile = File.Open("archive.zip", FileMode.Create))
{
    using (var archive = new Archive())
    {
        archive.CreateEntry("data.bin", "file.dat");
        archive.Save(zipFile);
    }
}

See Also

• class ArchiveEntrySettings
• class Archive
• namespace Aspose.Zip
• assembly Aspose.Zip

---

Archive(Stream, ArchiveLoadOptions, ArchiveEntrySettings)

Initializes a new instance of the Archive class and composes an entry list can be extracted from the archive.

public Archive(Stream sourceStream, ArchiveLoadOptions loadOptions = null, 
    ArchiveEntrySettings newEntrySettings = null)

Parameter	Type	Description
sourceStream	Stream	The source of the archive.
loadOptions	ArchiveLoadOptions	Options to load existing archive with.
newEntrySettings	ArchiveEntrySettings	Compression and encryption settings used for newly added ArchiveEntry items. If not specified, the most common Deflate compression without encryption would be used.

Exceptions

exception	condition
ArgumentException	sourceStream is not seekable.
InvalidDataException	Encryption header for AES contradicts WinZip compression method.

Remarks

This constructor does not decompress any entry. See Open method for decompressing.

Examples

The following example extracts an encrypted archive, then decompresses first entry to a MemoryStream.

var fs = File.OpenRead("encrypted.zip");
var extracted = new MemoryStream();
using (Archive archive = new Archive(fs, new ArchiveLoadOptions() { DecryptionPassword = "p@s$" }))
{
    using (var decompressed = archive.Entries[0].Open())
    {
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = decompressed.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }
}

See Also

• class ArchiveLoadOptions
• class ArchiveEntrySettings
• class Archive
• namespace Aspose.Zip
• assembly Aspose.Zip

---

Archive(string, ArchiveLoadOptions, ArchiveEntrySettings)

Initializes a new instance of the Archive class and composes entry list can be extracted from the archive.

public Archive(string path, ArchiveLoadOptions loadOptions = null, 
    ArchiveEntrySettings newEntrySettings = null)

Parameter	Type	Description
path	String	The fully qualified or the relative path to the archive file.
loadOptions	ArchiveLoadOptions	Options to load existing archive with.
newEntrySettings	ArchiveEntrySettings	Compression and encryption settings used for newly added ArchiveEntry items. If not specified, the most common Deflate compression without encryption would be used.

Exceptions

exception	condition
ArgumentNullException	path is null.
SecurityException	The caller does not have the required permission to access.
ArgumentException	The path is empty, contains only white spaces, or contains invalid characters.
UnauthorizedAccessException	Access to file path is denied.
PathTooLongException	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.
NotSupportedException	File at path contains a colon (:) in the middle of the string.
FileNotFoundException	The file is not found.
DirectoryNotFoundException	The specified path is invalid, such as being on an unmapped drive.
IOException	The file is already open.
InvalidDataException	File is corrupted.

Remarks

This constructor does not decompress any entry. See Open method for decompressing.

Examples

The following example extracts an encrypted archive, then decompresses first entry to a MemoryStream.

var extracted = new MemoryStream();
using (Archive archive = new Archive("encrypted.zip", new ArchiveLoadOptions() { DecryptionPassword = "p@s$" }))
{
    using (var decompressed = archive.Entries[0].Open())
    {
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = decompressed.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }
}

See Also

• class ArchiveLoadOptions
• class ArchiveEntrySettings
• class Archive
• namespace Aspose.Zip
• assembly Aspose.Zip

---

Archive(string, string[], ArchiveLoadOptions)

Initializes a new instance of the Archive class from multi-volume zip archive and composes an entry list can be extracted from the archive.

public Archive(string mainSegment, string[] segmentsInOrder, ArchiveLoadOptions loadOptions = null)

Parameter	Type	Description
mainSegment	String	Path to the last segment of multi-volume archive with the central directory.
segmentsInOrder	String[]	Paths to each segment but the last of multi-volume zip archive respecting order.
loadOptions	ArchiveLoadOptions	Options to load existing archive with.

Exceptions

exception	condition
EndOfStreamException	Cannot load ZIP headers because provided files are corrupted.

Examples

This sample extract to a directory an archive of three segments.

using (Archive a = new Archive("archive.zip", new string[] { "archive.z01", "archive.z02" }))
{
    a.ExtractToDirectory("destination");
}

See Also

• class ArchiveLoadOptions
• class Archive
• namespace Aspose.Zip
• assembly Aspose.Zip