Class XarFileEntry
Namespace: Aspose.Zip.Xar
Assembly: Aspose.Zip.dll (25.1.0)
表示 xar 压缩文件中的文件条目。
public sealed class XarFileEntry : XarEntry, IArchiveFileEntry
继承
object ← XarEntry ← XarFileEntry
实现
继承成员
XarEntry.ToString(), XarEntry.Name, XarEntry.FullPath, XarEntry.IsDirectory, XarEntry.Parent, XarEntry.CreationTime, XarEntry.LastAccessTime, XarEntry.LastWriteTime, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
属性
Length
获取条目的字节长度。
public long Length { get; }
属性值
方法
Extract(string)
根据提供的路径将条目提取到文件系统中。
public FileInfo Extract(string path)
参数
path
string
目标文件的路径。如果文件已存在,将被覆盖。
返回
已组成文件的信息。
示例
using (var archive = new XarArchive("archive.xar"))
{
((XarFileEntry)archive.Entries[0]).Extract("data.bin");
}
异常
path
为 null。
调用者没有访问所需的权限。
path
为空、仅包含空格或包含无效字符。
访问文件 path
被拒绝。
指定的 path
、文件名或两者超过系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须少于 248 个字符,文件名必须少于 260 个字符。
path
中间包含冒号 (:)。
压缩文件已损坏。
Extract(Stream)
将条目提取到提供的流中。
public void Extract(Stream destination)
参数
destination
Stream
目标流。必须可写。
示例
提取 xar 压缩文件的条目。
using (var archive = new XarArchive("archive.xar"))
{
((XarFileEntry)archive.Entries[0]).Extract(httpResponseStream);
}
异常
destination
不支持写入。
压缩文件已损坏。
Open()
打开条目以进行提取,并提供包含条目内容的流。
public Stream Open()
返回
表示条目内容的流。
示例
用法:
Stream decompressed = entry.Open();
.NET 4.0 及更高版本 - 使用 Stream.CopyTo 方法:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 及之前版本 - 手动复制字节:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### 备注
从流中读取以获取文件的原始内容。请参见示例部分。
### <a id="Aspose_Zip_Xar_XarFileEntry_CompressionProgressed"></a> CompressionProgressed
当原始流的一部分被压缩时引发。
```csharp
public event EventHandler<progresseventargs> CompressionProgressed
事件类型
EventHandler<ProgressEventArgs>
示例
archive.Entries.First().CompressionProgressed += (s, e) => { int percent = (int)((100 * (long)e.ProceededBytes) / entrySourceStream.Length); };
备注
事件发送者是 Aspose.Zip.Xar.XarFileEntry 实例。