Class CabEntry
Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)
نماینده یک فایل واحد درون آرشیو cab است.
public sealed class CabEntry : IArchiveFileEntry
وراثت
پیادهسازیها
اعضای وراثتیافته
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
ویژگیها
طول
طول ورودی را به بایتها دریافت میکند.
public uint Length { get; }
مقدار ویژگی
نام
نام ورودی را درون آرشیو دریافت میکند.
public string Name { get; }
مقدار ویژگی
متدها
Extract(string)
ورودی را به سیستم فایل با مسیر ارائهشده استخراج میکند.
public FileInfo Extract(string path)
پارامترها
path
string
مسیر به فایل مقصد. اگر فایل قبلاً وجود داشته باشد، بازنویسی خواهد شد.
بازگشت
اطلاعات فایل فایل ترکیبی.
مثالها
using (var archive = new CabArchive("archive.cab"))
{
archive.Entries[0].Extract("data.bin");
}
استثناها
path
null است.
فراخواننده اجازه لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
رد شده است.
path
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از ۲۴۸ کاراکتر و نام فایلها باید کمتر از ۲۶۰ کاراکتر باشد.
فایل در path
دارای دو نقطه (:) در وسط رشته است.
فایل یافت نشد.
مسیر مشخصشده نامعتبر است، مانند اینکه در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
راهاندازی جریان به دلیل دادههای نادرست شکست خورد.
آرشیو خراب است.
Extract(Stream)
ورودی را به جریانی که ارائه شده استخراج میکند.
public void Extract(Stream destination)
پارامترها
destination
Stream
جریان مقصد. باید قابل نوشتن باشد.
مثالها
استخراج یک ورودی از آرشیو cab.
using (var archive = new CabArchive("archive.cab"))
{
archive.Entries[0].Extract(httpResponseStream);
}
استثناها
destination
از نوشتن پشتیبانی نمیکند.
راهاندازی جریان به دلیل دادههای نادرست شکست خورد.
آرشیو خراب است.
Open()
ورودی را برای استخراج باز میکند و جریانی با محتوای ورودی ارائه میدهد.
public Stream Open()
بازگشت
جریانی که محتوای ورودی را نمایندگی میکند.
مثالها
استفاده:
Stream decompressed = entry.Open();
.نت ۴.۰ و بالاتر - از متد Stream.CopyTo استفاده کنید:
decompressed.CopyTo(httpResponse.OutputStream)
.نت ۳.۵ و قبل از آن - با دستنویس کردن بایتها:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### توضیحات
از جریان بخوانید تا محتوای اصلی فایل را دریافت کنید. به بخش مثالها مراجعه کنید.
#### استثناها
[NotSupportedException](https://learn.microsoft.com/dotnet/api/system.notsupportedexception)
راهاندازی جریان به دلیل دادههای نادرست شکست خورد.
[InvalidDataException](https://learn.microsoft.com/dotnet/api/system.io.invaliddataexception)
آرشیو خراب است.
### <a id="Aspose_Zip_Cab_CabEntry_ToString"></a> ToString\(\)
```csharp
public override string ToString()