Class RarArchive

Class RarArchive

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

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

public class RarArchive : IArchive, IDisposable

Inheritance

object RarArchive

Implements

IArchive , IDisposable

اعضای ارثی

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

Constructors

RarArchive(بایگانی برچسب: RarArchiveLoadOptions)

یک مثال جدید از کلاس Aspose.Zip.Rar.RarArchive را آغاز می کند و یک لیست ورودی را می سازد که می تواند از آرشیو استخراج شود.

public RarArchive(string path, RarArchiveLoadOptions loadOptions = null)

Parameters

path string

به طور کامل واجد شرایط یا مسیر نسبی به فایل آرشیو.

loadOptions RarArchiveLoadOptions

گزینه هایی برای بارگذاری آرشیو های موجود

Examples

مثال زیر یک آرشیو را استخراج می کند و سپس اولین ورودی را به یک .

var extracted = new MemoryStream();
using (RarArchive archive = new RarArchive("data.rar"))
{
    using (var decompressed = archive.Entries[0].Open())
    {
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = decompressed.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }
}

Remarks

این سازنده هیچ ورودی را از بین نمی برد. مشاهده Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) روش برای از بین بردن.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

RarArchive(بایگانی برچسب: RarArchiveLoadOptions)

یک مثال جدید از کلاس Aspose.Zip.Rar.RarArchive را آغاز می کند و یک لیست ورودی را می سازد که می تواند از آرشیو استخراج شود.

public RarArchive(Stream sourceStream, RarArchiveLoadOptions loadOptions = null)

Parameters

sourceStream Stream

منبع این آرشیو

loadOptions RarArchiveLoadOptions

گزینه هایی برای بارگذاری آرشیو های موجود

Examples

مثال زیر دسیفر و دکامپرس اولین ورودی به A .

var fs = File.OpenRead("encrypted.rar");
var extracted = new MemoryStream();
using (RarArchive archive = new RarArchive(fs, new RarArchiveLoadOptions() { DecryptionPassword = "p@s$" }))
{
    using (var decompressed = archive.Entries[0].Open())
    {
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = decompressed.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }
}

Remarks

این سازنده هیچ ورودی را از بین نمی برد. مشاهده Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) روش برای از بین بردن.

Exceptions

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

اشتباه امضای برای آرشیو. - یا - فایل یک آرشیو RAR نیست.

Properties

Entries

دریافت ورودی از Aspose.Zip.Rar.RarArchiveEntry نوع تشکیل آرشیو نادر.

public ReadOnlyCollection<rararchiveentry> Entries { get; }

ارزش املاک

ReadOnlyCollection &lt؛ RarArchiveEntry >

Methods

Dispose(بول)

انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

آیا منابع مدیریت شده باید از بین برود؟

Dispose()

انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.

public void Dispose()

ExtractToDirectory(String، String)

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

[Obsolete("For extraction encrypted RAR archive please provide password in constructor with Aspose.Zip.Rar.RarArchiveLoadOptions.DecryptionPassword")]
public void ExtractToDirectory(string destinationDirectory, string password = null)

Parameters

destinationDirectory string

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

password string

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

Examples

using (var archive = new RarArchive("archive.rar")) 
{ 
   archive.ExtractToDirectory("C:\extracted", "$ecRet");
}

Remarks

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.

NotSupportedException

اگر دایرکتوری وجود ندارد، مسیر حاوی یک کاراکتر ستون فقرات (:) است که بخشی از یک برچسب درایو نیست (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method. -or- path is prefixed with, or contains, only a colon character (:).

IOException

دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.

ExtractToDirectory(String)

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

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Examples

using (var archive = new RarArchive("archive.rar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.

NotSupportedException

اگر دایرکتوری وجود ندارد، مسیر حاوی یک کاراکتر ستون فقرات (:) است که بخشی از یک برچسب درایو نیست (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method. -or- path is prefixed with, or contains, only a colon character (:).

IOException

دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.

 فارسی