The Zip control implements a PKZip-compatible Zip compressor and decompressor.
The control uses the Deflate algorithm specified in RFC 1951 for compression, and produces and reads output compatible with PKZip, WinZip, etc.
To create a new archive, first set the ArchiveFile property to the name of the archive to be created. Then, specify the files to be compressed either by invoking IncludeFiles, or by adding a new object to the Files collection and setting the values of the FileDecompressedName and FileCompressedName. fields. Finally, call the Compress method to create the archive.
To decompress an existing archive, set ArchiveFile to the name of the archive to be decompressed. The ExtractToPath property may be set, and then calling the ExtractAll method will decompress all files in the archive to this path.
For finer control, the Scan method should be used to read the file information stored in the archive. This will fill out the information in the Files collection. The values of FileDecompressedName may then be changed if desired. Finally, ExtractAll may be used to decompress the entire archive, or Extract may be used for finer control.
Example (Creating an Archive)
ZipControl.ArchiveFile = "c:\test.zip" ZipControl.RecurseSubdirectories = true ZipControl.IncludeFiles("c:\foo\*") ZipControl.Compress()
Example (Extracting from an Archive)
ZipControl.ArchiveFile = "c:\temp.zip" ZipControl.ExtractToPath = "c:\extracted\" ZipControl.ExtractAll()
The following is the full list of the properties of the control with short descriptions. Click on the links for further details.
|ArchiveFile||The name of the zip, gzip, tar, or jar archive.|
|CompressionLevel||The compression level to use.|
|CompressionMethod||The compression method to use.|
|EncryptionAlgorithm||The algorithm used to encrypt files written to the archive.|
|ExcludedFiles||A list of files to exclude.|
|ExtractToPath||A base path to decompress to.|
|FileCount||The number of records in the File arrays.|
|FileAttributes||The attributes of the files to be compressed or decompressed.|
|FileComment||Specifies a comment for the entry in the zip file.|
|FileCompressedDate||The date and time of the entry, as stored within the archive.|
|FileCompressedName||The file name of the current file, as stored inside of the archive.|
|FileCompressedSize||The size of the compressed data, as compressed within the archive.|
|FileCompressionLevel||The compression level to use for the file.|
|FileCRC||The CRC value for the specified file found in the archive.|
|FileDecompressedName||The name of the file in the archive, as stored on the file system, outside the archive.|
|FileDecompressedSize||The size of the file, as decompressed outside the archive.|
|FileEncryptionAlgorithm||The algorithm used to encrypt the specified file written to the archive.|
|FileHash||The computed hash for the specified File.|
|FileInputData||When This property is set, the control will read in the data from This property instead of reading from the file contained in the DecompressedName property.|
|FilePassword||This property specifies the case-sensitive password used to encrypt or decrypt the current file.|
|FilePasswordRequired||This property describes whether or not the current file has been encrypted or not and requires a password to decompress.|
|OverwriteFiles||Whether or not to overwrite files.|
|Password||A password for the zip archive.|
|RecurseSubdirectories||Whether or not to recurse into subdirectories.|
|ZipComment||The comment for the entire zip file.|
|ZipData||(Decompression only) The zip file contents as a byte array.|
The following is the full list of the methods of the control with short descriptions. Click on the links for further details.
|Abort||Aborts the current operation.|
|AppendFiles||Adds specified files to an existing archive.|
|Compress||Creates the compressed archive.|
|Config||Sets or retrieves a configuration setting.|
|Delete||Deletes one or more files from an existing archive.|
|Extract||Extracts a single file, directory, or group of files, from the archive.|
|ExtractAll||Extracts all files from the compressed archive.|
|IncludeFiles||Specifies that the indicated files should be added to the archive.|
|Reset||Resets the control.|
|Scan||Scans the compressed archive.|
|Update||Will update certain files in an archive.|
The following is the full list of the events fired by the control with short descriptions. Click on the links for further details.
|BeginFile||Fired before each file is processed.|
|EndFile||Fired after each file is processed.|
|Error||Information about non-fatal errors.|
|Overwrite||Fired whenever a file exists and may be overwritten.|
|Password||Fired when a file is encrypted, and the file's password is incorrect.|
|Progress||Fired as progress is made.|
The following is a list of configuration settings for the control with short descriptions. Click on the links for further details.
|AESGenerateUniqueKeys||Whether to generate unique keys for each file encrypted.|
|CheckForFileLocks||If true, the control requests an exclusive lock during initialization.|
|CompressionMethod||Used to set the method of compression.|
|EnableStreamingEncryption||Whether to allow streaming and encryption simultaneously.|
|ExcludedAttributes||Attributes of files to be excluded.|
|ExtractFilesOnly||Whether to only extract the files contained within the archive.|
|FileHashAlgorithm||The algorithm to use when computing the file hash.|
|ForceZip64Format||Whether to explicitly compress a Zip64 format archive.|
|MarkAsText||Whether to mark files as text files.|
|OverwriteReadonlyFiles||Whether to overwrite readonly files.|
|PreserveModifiedTime||Whether or not to preserve the original modified time on extracted files.|
|RecalculateCRC||Whether to recalculate the CRC.|
|VerifyPassword||Check whether the specified Password can decrypt the archive without extracting files.|
|WriteToProgressEvent||Whether or not to write data to the Progress Event.|
|CodePage||The system code page used for Unicode to Multibyte translations.|
|UseInternalSecurityAPI||Tells the control whether or not to use the system security libraries or an internal implementation.|