Gzip Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

Gzip Configuration Settings


	CloseStreamAfterCompress: If true, the component will close the output stream after compression. This property is true by default. Therefore, by default, the output stream will be closed after compression is completed. In order to keep streams open after the compression completes, you must set this config to false.
	FileComment: Holds the comment associated with the archive. When compressing this may be set to include a comment in the archive. This will also hold the comment associated with an archive after calling Scan.
	PreserveModifiedTime: Whether or not to preserve the original modified time on extracted files. Specifies whether or not the modified time of the extracted files use the current time or the original time of the file in the archive. When set to True (default) the extracted files will have the same modified time as the original file. When set to False the modified time on the extracted files will be set to the current time.
	WriteToProgressEvent: Whether or not to write data to the Progress Event. If WriteToProgressEvent is set to true, then all data produced through invocations of Extract, ExtractAll, and Compress will be written to the Progress event as well as to disk. Applications may stream out the compressed or decompressed data by trapping this event and copying the data. If WriteToProgressEvent is set to false, the data will not be streamed out, and the Data parameter of the Progress event will contain null. By default, this config is set to false.
	FileDecompressedSize: Gets the size of the file, as decompressed outside the archive. If an archive is open for read (i.e. has been scanned or decompressed), this information will be read from the archive headers. If an archive is not open for read, the component will retrieve the information for the corresponding value of DecompressedName from the local file system. A value of -1 will be returned in case of an I/O error.

Base Configuration Settings


	GUIAvailable: Tells the component whether or not a message loop is available for processing events. In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation. In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GuiAvailable to false will ensure that the component does not attempt to process external events.
	UseBackgroundThread: Whether threads created by the component are background threads. If set to True, when the component creates a thread the thread's IsBackground property will be explicitly set to True. By default this setting is False.
	UseManagedSecurityAPI: Tells the component whether or not to use the system security libraries or a managed implementation. By default the component will use the system security libraries to perform cryptographic functions. This means calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the component to use the internal managed implementation instead of using the system's security API. Note that when this value is set the product's system dll is no longer required as a reference, as all unmanaged code is stored in this file.