# 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**](https://docs.telerik.com/devtools/winforms/introduction), the classes are merged in `Telerik.WinControls`, so you need to reference that package instead of `Telerik.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](https://www.telerik.com/document-processing-libraries/documentation/libraries/radziplibrary/features/update-ziparchive). |
| `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`](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Zip.IPlatformManager.html) 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. |

## See Also

* [Compression Settings](https://www.telerik.com/document-processing-libraries/documentation/libraries/radziplibrary/features/compression-settings)
* [Compress Stream](https://www.telerik.com/document-processing-libraries/documentation/libraries/radziplibrary/features/compress-stream)
* [Update ZipArchive](https://www.telerik.com/document-processing-libraries/documentation/libraries/radziplibrary/features/update-ziparchive)