Class ZArchive

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

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) لفك الضغط.

الاستثناءات

path فارغ.

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

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

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

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

DirectoryNotFoundException

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

FileNotFoundException

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

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

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

الطرق

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"));
    }
}

الاستثناءات

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

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

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfo فارغ.

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

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

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");
    }
}

الاستثناءات

path فارغ.

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

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

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

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

InvalidDataException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

ملاحظات

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

الاستثناءات

destinationDirectory فارغ.

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

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

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

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

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

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 يجب أن يكون قابلًا للبحث.

الاستثناءات

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

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");
}

الاستثناءات

destinationFileName فارغ.

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

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

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

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

الملف في 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");
}

الاستثناءات

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

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

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfo فارغ.

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

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

SetSource(string)

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

public void SetSource(string sourcePath)

المعلمات

sourcePath string

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

أمثلة

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

الاستثناءات

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

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

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

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

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