Class CabEntry

Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)

نماینده یک فایل واحد درون آرشیو cab است.

public sealed class CabEntry : IArchiveFileEntry

وراثت

object ← CabEntry

پیاده‌سازی‌ها

IArchiveFileEntry

اعضای وراثت‌یافته

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

ویژگی‌ها

طول

طول ورودی را به بایت‌ها دریافت می‌کند.

public uint Length { get; }

مقدار ویژگی

uint

نام

نام ورودی را درون آرشیو دریافت می‌کند.

public string Name { get; }

مقدار ویژگی

string

متدها

Extract(string)

ورودی را به سیستم فایل با مسیر ارائه‌شده استخراج می‌کند.

public FileInfo Extract(string path)

پارامترها

path string

مسیر به فایل مقصد. اگر فایل قبلاً وجود داشته باشد، بازنویسی خواهد شد.

بازگشت

FileInfo

اطلاعات فایل فایل ترکیبی.

مثال‌ها

using (var archive = new CabArchive("archive.cab"))
{
    archive.Entries[0].Extract("data.bin");
}

استثناها

ArgumentNullException

path null است.

SecurityException

فراخواننده اجازه لازم برای دسترسی را ندارد.

ArgumentException

path خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل path رد شده است.

PathTooLongException

path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از ۲۴۸ کاراکتر و نام فایل‌ها باید کمتر از ۲۶۰ کاراکتر باشد.

NotSupportedException

فایل در path دارای دو نقطه (:) در وسط رشته است.

FileNotFoundException

فایل یافت نشد.

DirectoryNotFoundException

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نامشخص باشد.

IOException

فایل در حال حاضر باز است.

NotSupportedException

راه‌اندازی جریان به دلیل داده‌های نادرست شکست خورد.

InvalidDataException

آرشیو خراب است.

Extract(Stream)

ورودی را به جریانی که ارائه شده استخراج می‌کند.

public void Extract(Stream destination)

پارامترها

destination Stream

جریان مقصد. باید قابل نوشتن باشد.

مثال‌ها

استخراج یک ورودی از آرشیو cab.

using (var archive = new CabArchive("archive.cab"))
{
    archive.Entries[0].Extract(httpResponseStream);
}

استثناها

ArgumentException

destination از نوشتن پشتیبانی نمی‌کند.

NotSupportedException

راه‌اندازی جریان به دلیل داده‌های نادرست شکست خورد.

InvalidDataException

آرشیو خراب است.

Open()

ورودی را برای استخراج باز می‌کند و جریانی با محتوای ورودی ارائه می‌دهد.

public Stream Open()

بازگشت

Stream

جریانی که محتوای ورودی را نمایندگی می‌کند.

مثال‌ها

استفاده: 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()

بازگشت

string