Class ZArchive

Class ZArchive

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

تمثل هذه الفئة ملف أرشيف Z (ضغط). استخدمها لتكوين أو استخراج أرشيفات Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

الوراثة

objectZArchive

التنفيذ

IArchive, IDisposable, IArchiveFileEntry

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

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

ملاحظات

انظر https://docs.fileformat.com/compression/z/

المُنشئات

ZArchive()

يُهيئ مثيلًا جديدًا من فئة Aspose.Zip.Z.ZArchive مُعدًا للضغط.

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

يُهيئ مثيلًا جديدًا من فئة Aspose.Zip.Z.ZArchive مُعدًا لفك الضغط.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

المعلمات

source Stream

مصدر الأرشيف.

loadOptions ZArchiveLoadOptions

الخيارات لتحميل الأرشيف بها.

ملاحظات

لا يقوم هذا المُنشئ بفك الضغط. انظر طريقة Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) لفك الضغط.

الاستثناءات

ArgumentException

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

ArgumentNullException

source فارغ.

ZArchive(string, ZArchiveLoadOptions)

يُهيئ مثيلًا جديدًا من فئة Aspose.Zip.Z.ZArchive مُعدًا لفك الضغط.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

المعلمات

path string

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

loadOptions ZArchiveLoadOptions

الخيارات لتحميل الأرشيف بها.

ملاحظات

لا يقوم هذا المُنشئ بفك الضغط. انظر طريقة Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) لفك الضغط.

الاستثناءات

ArgumentNullException

path فارغ.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

الطرق

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

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

Extract(Stream)

يستخرج أرشيف Z إلى دفق.

public void Extract(Stream destination)

المعلمات

destination Stream

دفق لتخزين البيانات المُفككة.

أمثلة

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

الاستثناءات

InvalidDataException

لا يمكن فك ضغط البيانات.

Extract(FileInfo)

يستخرج أرشيف Z إلى ملف.

public void Extract(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

معلومات الملف لتخزين البيانات المُفككة.

أمثلة

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

المسار إلى الملف للقراءة فقط أو هو دليل.

ArgumentNullException

fileInfo فارغ.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

لا يمكن فك ضغط البيانات.

Extract(string)

يستخرج أرشيف Z إلى ملف بواسطة المسار.

public FileInfo Extract(string path)

المعلمات

path string

المسار إلى الملف الذي سيخزن البيانات المُفككة.

Returns

FileInfo

معلومات الملف المستخرج.

أمثلة

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

الاستثناءات

ArgumentNullException

path فارغ.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

لا يمكن فك ضغط البيانات.

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

ملاحظات

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

الاستثناءات

ArgumentNullException

destinationDirectory فارغ.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

Save(Stream, ZArchiveSaveOptions)

يحفظ أرشيف xz إلى الدفق المقدم.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

المعلمات

output Stream

دفق الوجهة.

settings ZArchiveSaveOptions

إعدادات اختيارية لتكوين الأرشيف.

أمثلة

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

ملاحظات

output يجب أن يكون قابلًا للبحث.

الاستثناءات

ArgumentException

output لا يدعم البحث.

ArgumentNullException

output فارغ.

Save(string, ZArchiveSaveOptions)

يحفظ أرشيف Z إلى ملف الوجهة المقدم.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

المعلمات

destinationFileName string

+المسار للأرشيف الذي سيتم إنشاؤه. إذا كان اسم الملف المحدد يشير إلى ملف موجود، فسيتم الكتابة فوقه.

settings ZArchiveSaveOptions

إعدادات اختيارية لتكوين الأرشيف.

أمثلة

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

الاستثناءات

ArgumentNullException

destinationFileName فارغ.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.

public void SetSource(Stream source)

المعلمات

source Stream

الدفق المدخل للأرشيف.

أمثلة

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.

public void SetSource(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

معلومات الملف التي سيتم فتحها كدفق مدخل.

أمثلة

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

المسار إلى الملف للقراءة فقط أو هو دليل.

ArgumentNullException

fileInfo فارغ.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.

public void SetSource(string sourcePath)

المعلمات

sourcePath string

المسار إلى الملف الذي سيتم فتحه كدفق مدخل.

أمثلة

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

الاستثناءات

ArgumentNullException

sourcePath فارغ أو سلسلة فارغة.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 عربي