How to manage ZIP files
ZIP is an archive file format that supports lossless data compression. A ".ZIP" file may contain one or more files or directories that may have been compressed. Audio DJ Studio API for .NET comes with embedded support for this format and, apart from being able to manage general files compression and decompression, allows loading and playing sound files archived inside ZIP files that may be optionally protected with AES encryption.
ZIP files can be managed through the ZipMan class object accessible through the ZIP property; existing ZIP files can be opened with the ZIP.Open method: this method allows specifying a password that could be used for accessing entries protected through the legacy ZIP 2.0 encryption or through the latest AES encryption: you can know if a ZIP file is protected through the ZIP.IsProtected method.
You may also create a brand new ZIP file from scratch using the ZIP.Create method: also in this case you would have the option to protect your new ZIP file through encryption.
Once opened or created, existing entries of the ZIP file can be enumerated through the combination of the ZIP.EntriesCountGet and ZIP.EntryNameGet methods and extracted on the local disk through the ZIP.EntryExtractToFile method or inside a memory buffer through the ZIP.EntryExtractToMemory method: in this latest case, you can know how much room is needed for allocating the buffer through the ZIP.EntryUncompressedSizeGet method. It's important to note that, in order to load a sound file contained inside the ZIP file, the component doesn't need to extract it: the LoadSoundFromZip, LoadSoundFastFromZip and LoadSoundSyncFromZip methods can extract and automatically load the sound file from the ZIP file into a given player.
During lengthy operations for both compression and decompression, the container application is notified about the current percentage of advancement through the CallbackZipOperationPerc delegate.
Existing entries can be removed through the ZIP.EntryRemove method.
Samples of use of the ZipMan class in Visual C#.NET and Visual Basic.NET can be found inside the following samples installed with the product's setup package: