Class WimFileEntry
Namespace: Aspose.Zip.Wim
Assembly: Aspose.Zip.dll (25.2.0)
Represents single file within wim archive.
public sealed class WimFileEntry : WimEntry, IArchiveFileEntry
Inheritance
object ← WimEntry ← WimFileEntry
Implements
Inherited Members
WimEntry.ToString(), WimEntry.Archive, WimEntry.Image, WimEntry.Parent, WimEntry.Name, WimEntry.ShortName, WimEntry.FullPath, WimEntry.ChangeTime, WimEntry.CreationTime, WimEntry.LastAccessTime, WimEntry.LastWriteTime, WimEntry.ModificationTime, WimEntry.FileAttributes, WimEntry.AlternateDataStreams, WimEntry.HardLink, WimEntry.HasHardLinks, WimEntry.IsDirectory, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Properties
Length
Gets the length of the entry in bytes.
public long Length { get; }
Property Value
Methods
Extract(string)
Extracts the entry to the filesystem by the path provided.
public FileInfo Extract(string path)
Parameters
path
string
The path to destination file. If the file already exists, it will be overwritten.
Returns
The file info of composed file.
Examples
using (var archive = new WimArchive("archive.wim"))
{
archive.Images[0].RootDirectory.Files[0].Extract("data.bin");
}
Exceptions
path
is null.
The caller does not have the required permission to access.
The path
is empty, contains only white spaces, or contains invalid characters.
Access to file path
is denied.
The specified path
, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
File at path
contains a colon (:) in the middle of the string.
The file is not found.
The specified path is invalid, such as being on an unmapped drive.
The file is already open.
Archive is corrupted.
Extract(Stream)
Extracts the entry to the stream provided.
public void Extract(Stream destination)
Parameters
destination
Stream
Destination stream. Must be writable.
Examples
Extract an entry of wim archive.
using (var archive = new WimArchive("archive.wim"))
{
archive.Images[0].RootDirectory.Files[0].Extract(httpResponseStream);
}
Exceptions
destination
does not support writing.
Archive is corrupted.
Open()
Opens the entry for extraction and provides a stream with entry content.
public Stream Open()
Returns
The stream that represents the contents of the entry.
Examples
Usage:
Stream decompressed = entry.Open();
.NET 4.0 and higher - use Stream.CopyTo method:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 and before - copy bytes manually:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Remarks
Read from the stream to get original content of file. See examples section.