Zip Extensions
Besides the main ZipLibrary control, you can use a set of helper methods divided into two classes that help you implement scenarios faster. All these methods are in the Telerik.Windows.Zip.Extensions NuGet package.
In UI for WinForms, the classes are merged in
Telerik.WinControls, so you need to reference that package instead ofTelerik.Windows.Zip.Extensions.
This article lists the available classes and their members.
The ZipFile Class
With the ZipFile class, you can use static methods to create, extract, or open ZIP archives with minimal code. Starting with the Q2 2025 release, some methods now include an additional optional parameter (TimeSpan? timeout). The older overloads of these specific methods, which do not include this parameter, are now obsolete.
The following table describes the methods of the ZipFile class:
| Method | Description |
|---|---|
CreateEntryFromFile(this ZipArchive destination, string sourceFileName, string entryName, TimeSpan? timeout) | Archives a file by compressing it and adding it to the ZIP archive. Other overloads allow specifying CompressionLevel or CompressionSettings. See ZipArchiveEntry. |
CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName, TimeSpan? timeout) | Creates a ZIP archive containing the files and directories from the specified directory. Additional overloads allow configuring various settings for the entries. |
ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, TimeSpan? timeout) | Extracts all the files in the specified ZIP archive to a directory on the file system. |
ExtractToFile(this ZipArchiveEntry source, string destinationFileName, TimeSpan? timeout) | Extracts an entry in the ZIP archive to a file. You can also specify whether to overwrite an existing file with the same name as the destination file. |
Open(string archiveFileName, ZipArchiveMode mode) | Opens a ZIP archive at the specified path and in the specified mode. Another overload allows specifying the encoding for entry names. |
OpenRead(string archiveFileName) | Opens a ZIP archive for reading at the specified path. |
IsDirectoryEmpty(DirectoryInfo directoryInfo) | Indicates whether the specified directory is empty or not. |
The DotNetPlatformManager Class
This class implements the IPlatformManager interface, which provides platform-specific operations. Typically, you do not need to implement new platform managers because the default implementation already uses the current platform (.NET Framework) capabilities.
Properties
The following table describes the properties of the DotNetPlatformManager class:
| Property | Description |
|---|---|
AltDirectorySeparatorChar | Gets a platform-specific alternate character used to separate directory levels in a path string. |
DefaultEncoding | Gets the default encoding for this platform. |
DirectorySeparatorChar | Gets a platform-specific character used to separate directory levels in a path string. |
TemporaryStreamType | Gets or sets the type of the temporary stream. The default value is TemporaryStreamType.Memory. |
Methods
The following table describes the methods of the DotNetPlatformManager class:
| Method | Description |
|---|---|
CreateTemporaryStream() | Creates a temporary stream used for temporary operations. |
DeleteTemporaryStream(Stream stream) | Deletes the temporary stream. |
GetCryptoProvider(EncryptionSettingsBase settings) | Gets a crypto provider initialized by using the given encryption settings. |
IsEncodingSupported(Encoding encoding) | Indicates whether the specified encoding is supported for this platform. Returns true if the encoding is allowed in the ZIP file. |