Class RarArchiveEntry

نام ها : Aspose.Zip.Rar جمع آوری: Aspose.Zip.dll (25.5.0)

یک فایل در یک آرشیو وجود دارد

public abstract class RarArchiveEntry : IArchiveFileEntry

Inheritance

object ← RarArchiveEntry

Derived

RarArchiveEntryEncrypted , RarArchiveEntryPlain

Implements

IArchiveFileEntry

اعضای ارثی

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

Remarks

یک Aspose.Zip.Rar.RarArchiveEntry را به Aspose.Zip.Rar.RarArchiveEntry رمزگذاری کنید تا مشخص شود که آیا ورودی رمزگذاری شده است یا نه.

Properties

CompressedSize

اندازه یک فایل فشرده را دریافت کنید.

public ulong CompressedSize { get; }

ارزش املاک

ulong

CreationTime

تاریخ و زمان آفرینش را به دست می آورد.

public DateTime CreationTime { get; }

ارزش املاک

DateTime

IsDirectory

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

public bool IsDirectory { get; }

ارزش املاک

bool

LastAccessTime

آخرین تاریخ و زمان دسترسی را دریافت کنید.

public DateTime LastAccessTime { get; }

ارزش املاک

DateTime

ModificationTime

آخرین تاریخ و زمان اصلاح شده را دریافت کنید.

public DateTime ModificationTime { get; }

ارزش املاک

DateTime

Name

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

public string Name { get; }

ارزش املاک

string

Source

جریان منبع داده را برای ورودی دریافت کنید.

protected Stream Source { get; set; }

ارزش املاک

Stream

UncompressedSize

اندازه یک فایل اصلی را دریافت کنید.

public ulong UncompressedSize { get; }

ارزش املاک

ulong

Methods

Extract(String، String)

وارد سیستم فایل را از طریق مسیر ارائه شده خارج می کند.

public FileInfo Extract(string path, string password = null)

Parameters

path string

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

password string

رمز عبور اختیاری برای رمزگذاری

Returns

FileInfo

اطلاعات مربوط به فایل های ترکیب شده

Examples

۲ مطلب با کلمه ی کلیدی «RAR آرشیو» ثبت شده است

using (FileStream rarFile = File.Open("archive.rar", FileMode.Open))
{
    using (RarArchive archive = new RarArchive(rarFile))
    {
        archive.Entries[0].Extract("first.bin", "pass");
        archive.Entries[1].Extract("second.bin", "pass");
    }
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

InvalidDataException

اطلاعات خراب شده است. - یا- CRC یا MAC تایید برای ورودی شکست خورده است.

Extract(جریان، string)

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

public void Extract(Stream destination, string password = null)

Parameters

destination Stream

بایگانی برچسب ها: باید نوشته شود

password string

رمز عبور اختیاری برای رمزگذاری

Examples

یک ورودی از آرشیو نادر با رمز عبور استخراج کنید.

using (FileStream rarFile = File.Open("archive.zip", FileMode.Open))
{
    using (RarArchive archive = new RarArchive(rarFile))
    {
        archive.Entries[0].Extract(httpResponseStream, "p@s$");
    }
}

Exceptions

InvalidDataException

CRC یا MAC برای ورود شکست خورده است.

ArgumentException

destination’ does not support writing.

InvalidDataException

اطلاعات خراب شده است. - یا- CRC یا MAC تایید برای ورودی شکست خورده است.

Open(String)

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

public Stream Open(string password = null)

Parameters

password string

رمز عبور اختیاری برای رمزگذاری نیز می تواند در Aspose.Zip.Rar.RarArchiveLoadOptions.DecryptionPassword تنظیم شود.

Returns

Stream

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

Examples

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

#### Remarks

<p>Read from the stream to get the original content of a file. See examples section.</p>

### <a id="Aspose_Zip_Rar_RarArchiveEntry_ExtractionProgressed"></a> ExtractionProgressed

Raises when a portion of raw stream extracted.

```csharp
public event EventHandler<progresseventargs> ExtractionProgressed

نوع رویداد

EventHandler &lt؛ ProgressEventArgs >

Examples

archive.Entries[0].ExtractionProgressed += (s, e) => { int percent = (int)((100 * e.ProceededBytes) / ((RarArchiveEntry)s).UncompressedSize); };

Remarks

فرستنده رویداد یک مثال Aspose.Zip.Rar.RarArchiveEntry است.