Class LzipArchive

Class LzipArchive

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

تمثل هذه الفئة ملف أرشيف Lzip. استخدمها لتكوين أو استخراج أرشيفات Lzip.

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

الوراثة

objectLzipArchive

التنفيذ

IArchive, IDisposable, IArchiveFileEntry

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

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

المنشئات

LzipArchive(LzipArchiveSettings)

يهيئ مثيلًا جديدًا من Aspose.Zip.Lzip.LzipArchive.

public LzipArchive(LzipArchiveSettings settings = null)

المعلمات

settings LzipArchiveSettings

إعداد أرشيف lzip معين مع تعريف حجم القاموس.

LzipArchive(Stream)

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

public LzipArchive(Stream sourceStream)

المعلمات

sourceStream Stream

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

الملاحظات

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

الاستثناءات

ArgumentException

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

ArgumentNullException

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

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

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

الاستثناءات

InvalidOperationException

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

InvalidDataException

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

ArgumentNullException

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

ArgumentException

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

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

الاستثناءات

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo هو null.

DirectoryNotFoundException

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

IOException

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

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

الاستثناءات

InvalidOperationException

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

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

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

الملاحظات

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

الاستثناءات

ArgumentNullException

destinationDirectory هو null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

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

الاستثناءات

ArgumentException

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

ArgumentNullException

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

الاستثناءات

ArgumentNullException

destinationFileName هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination هو null.

DirectoryNotFoundException

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

IOException

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

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

الاستثناءات

ArgumentException

تدفق 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");
}

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo هو null.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string path)

المعلمات

path string

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

الأمثلة

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

الاستثناءات

ArgumentNullException

path هو null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 عربي