Class CabArchive
Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)
تمثل هذه الفئة ملف أرشيف cab.
public class CabArchive : 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 لفك الضغط.
الاستثناءات
sourceStream
هو null.
sourceStream
غير قابل للبحث.
sourceStream
ليس أرشيف cab صالح.
التيار قصير جدًا.
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 لفك الضغط.
الاستثناءات
path
هو null.
المستدعي ليس لديه الإذن المطلوب للوصول.
path
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف path
.
path
المحدد، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على منصات Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path
يحتوي على نقطتين (:) في منتصف السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح، مثل أن يكون على محرك غير مخصص.
الملف مفتوح بالفعل.
الملف قصير جدًا.
الخصائص
Entries
يحصل على إدخالات من نوع Aspose.Zip.Cab.CabEntry التي تشكل الأرشيف.
public ReadOnlyCollection<cabentry> Entries { get; }
قيمة الخاصية
ReadOnlyCollection<CabEntry>
الطرق
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");
}
ملاحظات
إذا كان الدليل غير موجود، فسيتم إنشاؤه.
الاستثناءات
path هو null
يتجاوز المسار المحدد، اسم الملف، أو كليهما الطول الأقصى المحدد من قبل النظام.
المستدعي ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.
إذا كان الدليل غير موجود، يحتوي المسار على حرف نقطتين (:) ليس جزءًا من تسمية محرك (“C:").
path هو سلسلة بطول صفر، يحتوي فقط على مسافات بيضاء، أو يحتوي على حرف أو أكثر غير صالحة. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام طريقة System.IO.Path.GetInvalidPathChars. -أو- path مسبوق بـ، أو يحتوي فقط على حرف نقطتين (:).
الدليل المحدد بواسطة path هو ملف. -أو- اسم الشبكة غير معروف.
الأرشيف تالف.