Class LzipArchive

sourceStream ليس قابلًا للتوجه.

sourceStream هو null.

InvalidDataException

رؤوس الأرشيف لا تتطابق مع نوع الأرشيف lzip.

LzipArchive(string)

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

public LzipArchive(string path)

المعلمات

path string

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

الأمثلة

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

الملاحظات

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

الاستثناءات

path هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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

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

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

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

InvalidOperationException

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

InvalidDataException

رؤوس الأرشيف لا تتطابق مع نوع الأرشيف lzip.

الخصائص

Settings

يحصل على إعداد أرشيف lzip معين.

public LzipArchiveSettings Settings { get; }

قيمة الخاصية

LzipArchiveSettings

الطرق

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

المعلمات

destination Stream

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

الأمثلة

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

الاستثناءات

لم تتم قراءة رؤوس الأرشيف ومعلومات الخدمة.

InvalidDataException

خطأ في البيانات في الرأس أو في التحقق من الصحة.

تدفق الوجهة هو null.

InvalidOperationException

تدفق الوجهة لا يدعم الكتابة.

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

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

الأمثلة

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

الاستثناءات

لم تتم قراءة رؤوس الأرشيف ومعلومات الخدمة.

لا يمتلك المتصل الإذن المطلوب لفتح fileInfo.

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

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

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

fileInfo هو null.

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

InvalidOperationException

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

Extract(string)

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

public void Extract(string path)

المعلمات

path string

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

الأمثلة

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

الاستثناءات

لم تتم قراءة رؤوس الأرشيف ومعلومات الخدمة.

path هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

الملاحظات

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

الاستثناءات

destinationDirectory هو null.

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

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

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

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

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

Save(Stream)

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

public void Save(Stream outputStream)

المعلمات

outputStream Stream

تدفق الوجهة.

الأمثلة

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

الملاحظات

outputStream يجب أن يكون قابلاً للتوجه.

الاستثناءات

outputStream لا يدعم التوجه.

outputStream هو null.

Save(string)

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

public void Save(string destinationFileName)

المعلمات

destinationFileName string

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

الأمثلة

using (var archive = new LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lz");
}

الاستثناءات

destinationFileName هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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

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

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

Save(FileInfo)

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

public void Save(FileInfo destination)

المعلمات

destination FileInfo

ملف معلومات الذي سيتم فتحه كتدفق وجهة.

الأمثلة

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

الاستثناءات

لا يمتلك المتصل الإذن المطلوب لفتح destination.

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

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

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

destination هو null.

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

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

SetSource(Stream)

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

public void SetSource(Stream source)

المعلمات

source Stream

تدفق الإدخال للأرشيف.

الأمثلة

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

الاستثناءات

تدفق source غير قابل للتوجه.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

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

الأمثلة

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

الاستثناءات

لا يمتلك المتصل الإذن المطلوب لفتح fileInfo.

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

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

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

fileInfo هو null.

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

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

SetSource(string)

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

public void SetSource(string path)

المعلمات

path string

المسار إلى الملف الذي سيتم ضغطه.

الأمثلة

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

الاستثناءات

path هو null.

لا يمتلك المتصل الإذن المطلوب للوصول.

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

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