Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
يمثل أرشيف ISO (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposableالوراثة
تنفيذ
الأعضاء الموروثة
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
المنشئات
IsoArchive()
يقوم بتهيئة مثيل جديد من فئة Aspose.Zip.Iso.IsoArchive وينشئ أرشيف ISO فارغ لإضافة ملفات ودلائل جديدة.
public IsoArchive()أمثلة
يوضح المثال التالي كيفية إنشاء أرشيف ISO فارغ جديد وإضافة ملفات إليه:
// إنشاء أرشيف ISO فارغ جديد
using(IsoArchive isoArchive = new IsoArchive())
{
// إضافة ملفات إلى أرشيف ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// حفظ أرشيف ISO إلى ملف
isoArchive.Save("new_archive.iso");
}IsoArchive(Stream, IsoLoadOptions)
يقوم بتهيئة مثيل جديد من فئة Aspose.Zip.Iso.IsoArchive ويؤلف قائمة الإدخالات التي يمكن استخراجها من الأرشيف.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)المعلمات
sourceStream Stream
مصدر الأرشيف. يجب أن يكون قابلًا للبحث.
loadOptions IsoLoadOptions
الخيارات لتحميل الأرشيف بها.
أمثلة
يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}ملاحظات
هذا المُنشئ لا يقوم بفك أي إدخال.
الاستثناءات
sourceStream هو null.
sourceStream غير قابل للبحث.
sourceStream ليس أرشيف ISO صالح.
IsoArchive(string, IsoLoadOptions)
يقوم بتهيئة مثيل جديد من فئة Aspose.Zip.Iso.IsoArchive ويؤلف قائمة الإدخالات التي يمكن استخراجها من الأرشيف.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)المعلمات
path string
مسار ملف الأرشيف.
loadOptions IsoLoadOptions
الخيارات لتحميل الأرشيف بها.
أمثلة
يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}ملاحظات
هذا المُنشئ لا يقوم بفك أي إدخال.
الاستثناءات
path هو null.
المستدعي ليس لديه الإذن المطلوب للوصول.
path فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف path.
المسار المحدد path، اسم الملف، أو كلاهما يتجاوز الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path يحتوي على نقطتين (:) في منتصف السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح، مثل أن يكون على محرك غير مخصص.
الملف مفتوح بالفعل.
الملف قصير جدًا.
الخصائص
Entries
يحصل على إدخالات من نوع Aspose.Zip.Iso.IsoEntry التي تشكل الأرشيف.
public ReadOnlyCollection<isoentry> Entries { get; }قيمة الخاصية
ReadOnlyCollection<IsoEntry>
الأساليب
CreateDirectory(string)
يضيف دليلاً إلى صورة ISO.
public IsoEntry CreateDirectory(string name)المعلمات
name string
مسار الدليل في ISO.
العائدات
الإدخال ISO المؤلف.
الاستثناءات
تم فتح الأرشيف للاستخراج.
name هو null أو فارغ.
CreateEntry(string, string)
يضيف ملفًا إلى صورة ISO.
public IsoEntry CreateEntry(string name, string filePath)المعلمات
name string
مسار الملف في ISO.
filePath string
مسار الملف.
العائدات
الإدخال ISO المؤلف.
الاستثناءات
filePath هو null.
filePath فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف filePath.
يتجاوز filePath المحدد الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في filePath يحتوي على نقطتين (:) في منتصف السلسلة.
حدث خطأ في الإدخال/الإخراج أثناء فتح الملف.
CreateEntry(string, Stream)
يضيف ملفًا إلى صورة ISO.
public IsoEntry CreateEntry(string name, Stream source)المعلمات
name string
مسار الملف في ISO.
source Stream
تيار يحتوي على بيانات الملف.
العائدات
الإدخال ISO المؤلف.
CreateEntry(string)
يضيف ملفًا إلى صورة ISO.
public IsoEntry CreateEntry(string name)المعلمات
name string
مسار الدليل في ISO.
العائدات
الإدخال ISO المؤلف.
الاستثناءات
name هو null أو فارغ.
تم فتح الأرشيف للاستخراج.
Dispose()
ينفذ المهام المحددة بواسطة التطبيق المتعلقة بتحرير، وإصدار، أو إعادة تعيين الموارد غير المُدارة.
public void Dispose()ExtractToDirectory(string)
يستخرج جميع الإدخالات إلى الدليل المحدد.
public void ExtractToDirectory(string destinationDirectory)المعلمات
destinationDirectory string
الدليل لاستخراج الإدخالات إليه.
أمثلة
يوضح المثال التالي كيفية استخراج جميع الإدخالات إلى دليل:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}الاستثناءات
يتم طرحها عندما يكون الأرشيف في وضع التحرير.
يتم طرحها عندما يكون destinationDirectory هو null.
Save(string, IsoSaveOptions)
يحفظ صورة ISO إلى المسار المحدد.
public void Save(string path, IsoSaveOptions saveOptions = null)المعلمات
path string
المسار الذي سيتم حفظ صورة ISO فيه.
saveOptions IsoSaveOptions
خيارات لحفظ أرشيف ISO بها.
أمثلة
يوضح المثال التالي كيفية حفظ أرشيف ISO إلى ملف:
// إنشاء أرشيف ISO فارغ جديد
using(IsoArchive isoArchive = new IsoArchive())
{
// إضافة ملفات إلى أرشيف ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// حفظ أرشيف ISO إلى ملف
isoArchive.Save("new_archive.iso");
}الاستثناءات
يتم طرحها عندما لا يكون الأرشيف في وضع التحرير.
يتم طرحها عندما يكون path هو null.
يتم طرحها عندما يكون المسار المحدد غير صالح، مثل أن يكون على محرك غير مخصص.
يتم طرحها عندما يكون الملف مفتوحًا بالفعل.
يتم طرحها عندما يتم رفض الوصول إلى الملف path.
يتم طرحها عندما يتجاوز path المحدد الطول الأقصى المحدد بواسطة النظام.
Save(Stream, IsoSaveOptions)
يحفظ صورة ISO إلى التيار المحدد.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)المعلمات
stream Stream
التيار الذي سيتم حفظ صورة ISO فيه.
saveOptions IsoSaveOptions
خيارات لحفظ أرشيف ISO بها.
أمثلة
يوضح المثال التالي كيفية حفظ أرشيف ISO إلى تيار ذاكرة:
// إنشاء أرشيف ISO فارغ جديد
using(IsoArchive isoArchive = new IsoArchive())
{
// إضافة ملفات إلى أرشيف ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// حفظ أرشيف ISO إلى تيار ذاكرة
isoArchive.Save(memoryStream);
}الاستثناءات
يتم طرحها عندما لا يكون الأرشيف في وضع التحرير.
يتم طرحها عندما يكون stream هو null.
يتم طرحها عندما لا يكون stream قابلًا للكتابة.
