Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
تمثل هذه الفئة ملف أرشيف Lzip. استخدمها لتكوين أو استخراج أرشيفات Lzip.
public class LzipArchive : 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()
المنشئات
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) لفك الضغط.
الاستثناءات
sourceStream
ليس قابلًا للتوجه.
sourceStream
هو null.
رؤوس الأرشيف لا تتطابق مع نوع الأرشيف 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
على نقطتين (:) في منتصف السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح، مثل كونه على محرك غير مخصص.
الملف مفتوح بالفعل.
رؤوس الأرشيف لا تتطابق مع نوع الأرشيف lzip.
الخصائص
Settings
يحصل على إعداد أرشيف lzip معين.
public LzipArchiveSettings Settings { get; }
قيمة الخاصية
الطرق
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);
}
}
}
الاستثناءات
لم تتم قراءة رؤوس الأرشيف ومعلومات الخدمة.
خطأ في البيانات في الرأس أو في التحقق من الصحة.
تدفق الوجهة هو null.
تدفق الوجهة لا يدعم الكتابة.
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.
المسار المحدد غير صالح، مثل كونه على محرك غير مخصص.
الملف مفتوح بالفعل.
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
المحدد، اسم الملف، أو كليهما الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على منصات Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
يحتوي الملف في 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
.
يتجاوز path
المحدد، اسم الملف، أو كليهما الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على منصات Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
يحتوي الملف في path
على نقطتين (:) في منتصف السلسلة.