Class RarArchive
اسم الفضاء : Aspose.Zip.Rar تجميع: Aspose.Zip.dll (25.5.0)
هذه الفئة تمثل ملف أرشيف RAR. استخدمها لاستخراج أرشيف RAR.
public class RarArchive : IArchive, IDisposableInheritance
Implements
الأعضاء الموروثين
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
path’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
RarArchive(البث، RarArchiveLoadOptions)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Rar.RarArchive ويجمع قائمة إدخالات يمكن استخراجها من الأرشيف.
public RarArchive(Stream sourceStream, RarArchiveLoadOptions loadOptions = null)Parameters
sourceStream Stream
مصدر الأرشيف .
loadOptions RarArchiveLoadOptions
خيارات تحميل الأرشيف الحالي مع.
Examples
على سبيل المثال التالي، تفكيك وتفكيك الإدخال الأول إلى .
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
sourceStream’ is not seekable.
خطأ التوقيع على الأرشيف. - أو - الملف ليس أرشيف RAR.
Properties
Entries
يحصل على إدخالات من Aspose.Zip.Rar.RarArchiveEntry النوع الذي يشكل الأرشيف الغريب.
public ReadOnlyCollection<rararchiveentry> Entries { get; }قيمة الممتلكات
ReadOnlyCollection <؛ RarArchiveEntry >
Methods
Dispose(بول)
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
هل ينبغي تخصيص الموارد التي يتم إدارةها؟
Dispose()
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
public void Dispose()ExtractToDirectory(ستيفن، ستيفن)
استخراج جميع الملفات في الأرشيف إلى الدليل المقدمة.
[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
destinationDirectory’ is null.
على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرف، وأسماء الملفات يجب أن تكون أقل من 260 حرف.
لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.
إذا لم يكن الدليل موجودًا ، فإن المسار يحتوي على حرف العمود الفقري (:) الذي ليس جزءًا من علامة محرك الأقراص (“C:”).
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 (:).
المجلد المحدد بالطريق هو ملف. -أو- اسم الشبكة غير معروف.
ExtractToDirectory(الستار)
استخراج جميع الملفات في الأرشيف إلى الدليل المقدمة.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
الطريق إلى الدليل لوضع الملفات المستخرجة في.
Examples
using (var archive = new RarArchive("archive.rar"))
{
archive.ExtractToDirectory("C:\extracted");
}Remarks
إذا لم يكن الدليل موجودًا ، فسيتم إنشاؤه.
Exceptions
destinationDirectory’ is null.
على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرف، وأسماء الملفات يجب أن تكون أقل من 260 حرف.
لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.
إذا لم يكن الدليل موجودًا ، فإن المسار يحتوي على حرف العمود الفقري (:) الذي ليس جزءًا من علامة محرك الأقراص (“C:”).
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 (:).
المجلد المحدد بالطريق هو ملف. -أو- اسم الشبكة غير معروف.
