ZipFileExtensions::ExtractToFile Method (ZipArchiveEntry^, String^)
Extracts an entry in the zip archive to a file.
Assembly: System.IO.Compression.FileSystem (in System.IO.Compression.FileSystem.dll)
public: [ExtensionAttribute] static void ExtractToFile( ZipArchiveEntry^ source, String^ destinationFileName )
Parameters
- source
-
Type:
System.IO.Compression::ZipArchiveEntry^
The zip archive entry to extract a file from.
- destinationFileName
-
Type:
System::String^
The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory.
| Exception | Condition |
|---|---|
| ArgumentException | destinationFileName is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars. -or- destinationFileName specifies a directory. |
| ArgumentNullException | destinationFileName is null. |
| PathTooLongException | The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. |
| DirectoryNotFoundException | The specified path is invalid (for example, it is on an unmapped drive). |
| IOException | destinationFileName already exists. -or- An I/O error occurred. -or- The entry is currently open for writing. -or- The entry has been deleted from the archive. |
| UnauthorizedAccessException | The caller does not have the required permission to create the new file. |
| InvalidDataException | The entry is missing from the archive, or is corrupt and cannot be read. -or- The entry has been compressed by using a compression method that is not supported. |
| ObjectDisposedException | The zip archive that this entry belongs to has been disposed. |
| NotSupportedException | destinationFileName is in an invalid format. -or- The zip archive for this entry was opened in Create mode, which does not permit the retrieval of entries. |
If the destination file already exists, this method does not overwrite it; it throws an IOException exception. To overwrite an existing file, use the ExtractToFile(ZipArchiveEntry^, String^, Boolean) method overload instead.
The last write time of the file is set to the last time the entry in the zip archive was changed; this value is stored in the LastWriteTime property.
You cannot use this method to extract a directory; use the ExtractToDirectory method instead.
Available since 10
.NET Framework
Available since 4.5