Class LzmaArchive

Class LzmaArchive

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

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

public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry

الوراثة

objectLzmaArchive

التنفيذ

IArchive, IDisposable, IArchiveFileEntry

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

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

المنشئات

LzmaArchive(LzmaArchiveSettings)

يهيئ مثيلًا جديدًا من فئة Aspose.Zip.LZMA.LzmaArchive ويقوم بتكوين الأرشيف بتنسيق lzma.

public LzmaArchive(LzmaArchiveSettings settings = null)

المعلمات

settings LzmaArchiveSettings

مجموعة من الإعدادات الخاصة بأرشيف lzma.

LzmaArchive(Stream)

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

public LzmaArchive(Stream source)

المعلمات

source Stream

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

ملاحظات

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

الاستثناءات

ArgumentException

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

ArgumentNullException

source فارغ.

LzmaArchive(string)

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

public LzmaArchive(string path)

المعلمات

path string

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

أمثلة

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

ملاحظات

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

الاستثناءات

ArgumentNullException

path فارغ.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

الطرق

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

المعلمات

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

المعلمات

destination Stream

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

أمثلة

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

الاستثناءات

InvalidOperationException

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

InvalidDataException

الأرشيف تالف.

ArgumentNullException

دفق الوجهة فارغ.

ArgumentException

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

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

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

أمثلة

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

الاستثناءات

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

الملف غير موجود.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo فارغ.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

الأرشيف تالف.

Extract(string)

يستخرج أرشيف lzma إلى ملف عن طريق المسار.

public void Extract(string path)

المعلمات

path string

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

أمثلة

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

الاستثناءات

InvalidOperationException

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

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

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

InvalidDataException

الأرشيف تالف.

Save(Stream)

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

public void Save(Stream output)

المعلمات

output Stream

دفق الوجهة.

أمثلة

using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
    using (var archive = new LzmaArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzmaFile);
     }
}

ملاحظات

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

الاستثناءات

ArgumentException

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

ArgumentNullException

output فارغ.

Save(FileInfo)

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

public void Save(FileInfo destination)

المعلمات

destination FileInfo

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

أمثلة

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

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

الملف غير موجود.

UnauthorizedAccessException

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

ArgumentNullException

destination فارغ.

DirectoryNotFoundException

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

IOException

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

Save(string)

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

public void Save(string destinationFileName)

المعلمات

destinationFileName string

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

أمثلة

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

الاستثناءات

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 LzmaArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lzma");
}

الاستثناءات

ArgumentException

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

المعلمات

fileInfo FileInfo

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

أمثلة

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

الاستثناءات

SecurityException

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

ArgumentException

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

FileNotFoundException

الملف غير موجود.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo فارغ.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

المعلمات

sourcePath string

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

أمثلة

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

الاستثناءات

ArgumentNullException

sourcePath فارغ.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 عربي