Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
تمثل هذه الفئة ملف أرشيف LZMA. استخدمها لتكوين أو استخراج أرشيفات LZMA.
public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry
الوراثة
التنفيذ
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) لفك الضغط.
الاستثناءات
source
غير قابل للبحث.
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) لفك الضغط.
الاستثناءات
path
فارغ.
المتصل ليس لديه الإذن المطلوب للوصول.
path
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف path
.
المسار المحدد path
، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على أنظمة التشغيل المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في 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);
}
}
}
الاستثناءات
لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.
الأرشيف تالف.
دفق الوجهة فارغ.
دفق الوجهة لا يدعم الكتابة.
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"));
}
}
الاستثناءات
لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.
المتصل ليس لديه الإذن المطلوب لفتح fileInfo
.
مسار الملف فارغ أو يحتوي فقط على مسافات بيضاء.
الملف غير موجود.
المسار إلى الملف للقراءة فقط أو هو دليل.
fileInfo
فارغ.
المسار المحدد غير صالح، مثل كونه على محرك غير مخصص.
الملف مفتوح بالفعل.
الأرشيف تالف.
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");
}
}
الاستثناءات
لم يتم قراءة رؤوس الأرشيف ومعلومات الخدمة.
path
فارغ.
المتصل ليس لديه الإذن المطلوب للوصول.
path
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف path
.
المسار المحدد path
، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على أنظمة التشغيل المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path
يحتوي على نقطتين (:) في منتصف السلسلة.
الأرشيف تالف.
ExtractToDirectory(string)
يستخرج محتوى الأرشيف إلى الدليل المقدم.
public void ExtractToDirectory(string destinationDirectory)
المعلمات
destinationDirectory
string
المسار إلى الدليل لوضع الملفات المستخرجة فيه.
ملاحظات
إذا لم يكن الدليل موجودًا، فسيتم إنشاؤه.
الاستثناءات
destinationDirectory
فارغ.
المسار المحدد، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على أنظمة التشغيل المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا وأسماء الملفات أقل من 260 حرفًا.
المتصل ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.
إذا لم يكن الدليل موجودًا، يحتوي المسار على حرف نقطتين (:) ليس جزءًا من تسمية محرك (“C:").
destinationDirectory
سلسلة بطول صفر، تحتوي فقط على مسافات بيضاء، أو تحتوي على حرف واحد أو أكثر غير صالحة. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام طريقة System.IO.Path.GetInvalidPathChars.
-أو- المسار مضاف له، أو يحتوي فقط على حرف نقطتين (:).
الدليل المحدد بواسطة المسار هو ملف. -أو- اسم الشبكة غير معروف.
الأرشيف تالف.
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
يجب أن يكون قابلًا للبحث.
الاستثناءات
output
لا يدعم البحث.
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"));
}
الاستثناءات
المتصل ليس لديه الإذن المطلوب لفتح destination
.
مسار الملف فارغ أو يحتوي فقط على مسافات بيضاء.
الملف غير موجود.
المسار إلى الملف للقراءة فقط أو هو دليل.
destination
فارغ.
المسار المحدد غير صالح، مثل كونه على محرك غير مخصص.
الملف مفتوح بالفعل.
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");
}
الاستثناءات
destinationFileName
فارغ.
المتصل ليس لديه الإذن المطلوب للوصول.
destinationFileName
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف destinationFileName
.
المسار المحدد destinationFileName
، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على أنظمة التشغيل المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في 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");
}
الاستثناءات
دفق 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");
}
الاستثناءات
المتصل ليس لديه الإذن المطلوب لفتح fileInfo
.
مسار الملف فارغ أو يحتوي فقط على مسافات بيضاء.
الملف غير موجود.
المسار إلى الملف للقراءة فقط أو هو دليل.
fileInfo
فارغ.
المسار المحدد غير صالح، مثل كونه على محرك غير مخصص.
الملف مفتوح بالفعل.
SetSource(string)
يحدد المحتوى الذي سيتم ضغطه داخل الأرشيف.
public void SetSource(string sourcePath)
المعلمات
sourcePath
string
المسار إلى الملف الذي سيتم فتحه كدفق مدخل.
أمثلة
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
الاستثناءات
sourcePath
فارغ.
المتصل ليس لديه الإذن المطلوب للوصول.
sourcePath
فارغ، يحتوي فقط على مسافات بيضاء، أو يحتوي على أحرف غير صالحة.
تم رفض الوصول إلى الملف sourcePath
.
المسار المحدد sourcePath
، اسم الملف، أو كليهما يتجاوز الطول الأقصى المحدد بواسطة النظام. على سبيل المثال، على أنظمة التشغيل المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في sourcePath
يحتوي على نقطتين (:) في منتصف السلسلة.