Class CabArchive

Class CabArchive

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

تمثل هذه الفئة ملف أرشيف cab.

public class CabArchive : IArchive, IDisposable

الوراثة

objectCabArchive

تنفيذ

IArchive, IDisposable

الأعضاء الموروثة

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

المنشئات

CabArchive(Stream)

يهيئ مثيلًا جديدًا من فئة Aspose.Zip.Cab.CabArchive ويجمع قائمة الإدخالات التي يمكن استخراجها من الأرشيف.

public CabArchive(Stream sourceStream)

المعلمات

sourceStream Stream

مصدر الأرشيف. يجب أن يكون قابلًا للبحث.

أمثلة

يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.

using (var archive = new CabArchive(File.OpenRead("archive.cab")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

ملاحظات

لا يقوم هذا المنشئ بفك أي إدخال. راجع طريقة Aspose.Zip.Cab.CabEntry.Open لفك الضغط.

الاستثناءات

ArgumentNullException

sourceStream هو null.

ArgumentException

sourceStream غير قابل للبحث.

InvalidDataException

sourceStream ليس أرشيف cab صالح.

EndOfStreamException

التيار قصير جدًا.

CabArchive(string)

يهيئ مثيلًا جديدًا من فئة Aspose.Zip.Cab.CabArchive ويجمع قائمة الإدخالات التي يمكن استخراجها من الأرشيف.

public CabArchive(string path)

المعلمات

path string

المسار إلى ملف الأرشيف.

أمثلة

يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.

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

ملاحظات

لا يقوم هذا المنشئ بفك أي إدخال. راجع طريقة Aspose.Zip.Cab.CabEntry.Open لفك الضغط.

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

المستدعي ليس لديه الإذن المطلوب للوصول.

ArgumentException

path فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.

UnauthorizedAccessException

تم رفض الوصول إلى الملف path.

PathTooLongException

path المحدد، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على منصات Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.

NotSupportedException

الملف في path يحتوي على نقطتين (:) في منتصف السلسلة.

FileNotFoundException

لم يتم العثور على الملف.

DirectoryNotFoundException

المسار المحدد غير صالح، مثل أن يكون على محرك غير مخصص.

IOException

الملف مفتوح بالفعل.

EndOfStreamException

الملف قصير جدًا.

الخصائص

Entries

يحصل على إدخالات من نوع Aspose.Zip.Cab.CabEntry التي تشكل الأرشيف.

public ReadOnlyCollection<cabentry> Entries { get; }

قيمة الخاصية

ReadOnlyCollection<CabEntry&gt;

الطرق

Dispose(bool)

ينفذ مهام محددة بواسطة التطبيق مرتبطة بتحرير أو إعادة تعيين الموارد غير المدارة.

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

ما إذا كانت الموارد المدارة يجب أن يتم التخلص منها.

Dispose()

ينفذ مهام محددة بواسطة التطبيق مرتبطة بتحرير أو إعادة تعيين الموارد غير المدارة.

public void Dispose()

ExtractToDirectory(string)

يستخرج جميع الملفات في الأرشيف إلى الدليل المقدم.

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

المسار إلى الدليل لوضع الملفات المستخرجة فيه.

أمثلة

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

ملاحظات

إذا كان الدليل غير موجود، فسيتم إنشاؤه.

الاستثناءات

ArgumentNullException

path هو null

PathTooLongException

يتجاوز المسار المحدد، اسم الملف، أو كليهما الطول الأقصى المحدد من قبل النظام.

SecurityException

المستدعي ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.

NotSupportedException

إذا كان الدليل غير موجود، يحتوي المسار على حرف نقطتين (:) ليس جزءًا من تسمية محرك (“C:").

ArgumentException

path هو سلسلة بطول صفر، يحتوي فقط على مسافات بيضاء، أو يحتوي على حرف أو أكثر غير صالحة. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام طريقة System.IO.Path.GetInvalidPathChars. -أو- path مسبوق بـ، أو يحتوي فقط على حرف نقطتين (:).

IOException

الدليل المحدد بواسطة path هو ملف. -أو- اسم الشبكة غير معروف.

InvalidDataException

الأرشيف تالف.

 عربي