Class LzipArchive

Class LzipArchive

اسم الفضاء : Aspose.Zip.Lzip تجميع: Aspose.Zip.dll (25.5.0)

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

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object LzipArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

الأعضاء الموروثين

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

Constructors

LzipArchive(LzipArchiveSettings)

يبدأ مثال جديد من Aspose.Zip.Lzip.LzipArchive.

public LzipArchive(LzipArchiveSettings settings = null)

Parameters

settings LzipArchiveSettings

إعداد ملف خاص LZIP مع تعريف حجم القاموس.

LzipArchive(Stream)

يبدأ مثالًا جديدًا من فئة Aspose.Zip.Lzip.LzipArchive مستعدة للتخفيف.

public LzipArchive(Stream sourceStream)

Parameters

sourceStream Stream

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

Remarks

انظر Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) طريقة للتخفيف من الضغط.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

InvalidDataException

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

LzipArchive(الستار)

يبدأ مثالًا جديدًا من فئة Aspose.Zip.Lzip.LzipArchive مستعدة للتخفيف.

public LzipArchive(string path)

Parameters

path string

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

Examples

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

Remarks

انظر Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) طريقة للتخفيف من الضغط.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

لا يحصل المتصل على إذن الوصول المطلوب.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.

NotSupportedException

ملف في path’ يحتوي على عمود (:) في وسط السلسلة.

FileNotFoundException

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

DirectoryNotFoundException

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

IOException

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

InvalidDataException

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

Properties

Settings

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

public LzipArchiveSettings Settings { get; }

قيمة الممتلكات

LzipArchiveSettings

Methods

Dispose()

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

public void Dispose()

Dispose(بول)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

هل ينبغي تخصيص الموارد التي يتم إدارةها؟

Extract(Stream)

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

public void Extract(Stream destination)

Parameters

destination Stream

تدفق لتخزين البيانات المضغوطة.

Examples

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

Exceptions

InvalidOperationException

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

InvalidDataException

خطأ في البيانات في العنوان أو التفتيش.

ArgumentNullException

تدفق الوجهة صفر.

ArgumentException

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

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo لتخزين البيانات المضغوطة

Examples

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

Exceptions

InvalidOperationException

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

SecurityException

لا يحصل المتصل على السماح المطلوب لفتح fileInfo'.

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

IOException

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

Extract(الستار)

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

public void Extract(string path)

Parameters

path string

الطريق إلى الملف الذي سيتم تخزين البيانات المضغوطة.

Examples

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

Exceptions

InvalidOperationException

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

ArgumentNullException

path’ is null.

SecurityException

لا يحصل المتصل على إذن الوصول المطلوب.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.

NotSupportedException

ملف في path’ يحتوي على عمود (:) في وسط السلسلة.

ExtractToDirectory(الستار)

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

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.

NotSupportedException

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

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

Save(Stream)

تخزين أرشيف lzip إلى التيار المقدمة.

public void Save(Stream outputStream)

Parameters

outputStream Stream

النطاق المستهدف

Examples

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

Remarks

يجب أن تكون قابلة للبحث.

Exceptions

ArgumentException

outputStream’ does not support seeking.

ArgumentNullException

outputStream’ is null.

Save(الستار)

تخزين أرشيف lzip إلى ملف الوجهة المقدمة.

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

لا يحصل المتصل على إذن الوصول المطلوب.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

Save(FileInfo)

تخزين أرشيف lzip إلى ملف الوجهة المقدمة.

public void Save(FileInfo destination)

Parameters

destination FileInfo

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

Examples

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

Exceptions

SecurityException

لا يحصل المتصل على السماح المطلوب لفتح destination".

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

IOException

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

SetSource(Stream)

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

public void SetSource(Stream source)

Parameters

source Stream

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

Examples

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

Exceptions

ArgumentException

تدفق المصدر غير قابل للبحث.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

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

Examples

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

Exceptions

SecurityException

لا يحصل المتصل على السماح المطلوب لفتح fileInfo'.

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.

IOException

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

SetSource(الستار)

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

public void SetSource(string path)

Parameters

path string

الطريق إلى التسجيل لتكون مضغوطة.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

لا يحصل المتصل على إذن الوصول المطلوب.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.

NotSupportedException

ملف في path’ يحتوي على عمود (:) في وسط السلسلة.

 عربي