Class Lz4Archive
اسم الفضاء : Aspose.Zip.Lz4 تجميع: Aspose.Zip.dll (25.5.0)
هذه الفئة تمثل ملف LZ4 الأرشيف.استخدمه لاستخراج أو تكوين ملفات L Z4.
public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
الأعضاء الموروثين
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
Lz4Archive(Stream)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Lz4.Lz4أرشيف جاهزة للتخفيف.
public Lz4Archive(Stream sourceStream)Parameters
sourceStream Stream
مصدر الأرشيف .
Examples
افتح أرشيفًا من تدفق واستخراجها إلى
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
archive.Open().CopyTo(ms);Remarks
هذا المصنع لا يقطع. انظر Aspose.Zip.Lz4.Lz4Archive.Open طريقة للقطع.
Exceptions
لا يمكن قراءة من sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
sourceStream’ لديه توقيع خاطئ.
Lz4Archive(الستار)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Lz4.Lz4Archive.
public Lz4Archive(string path)Parameters
path string
الطريق إلى ملف الأرشيف.
Examples
افتح ملفًا من الملف حسب الطريق واستخراجها إلى
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
archive.Open().CopyTo(ms);Remarks
هذا المصنع لا يقطع. انظر Aspose.Zip.Lz4.Lz4Archive.Open طريقة للقطع.
Exceptions
path’ is null.
لا يتمتع المستخدم بالترخيص المطلوب للوصول إلى
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
الملف قصير جداً.
البيانات الموجودة في الملف لديها التوقيع الخاطئ.
Lz4Archive(Lz4ArchiveSetting)
يبدأ حالة جديدة من فئة Aspose.Zip.Lz4.Lc4أرشيف جاهزة للضغط.
public Lz4Archive(Lz4ArchiveSetting settings = null)Parameters
settings Lz4ArchiveSetting
إعداد الأرشيف المركب.
Methods
Dispose()
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
public void Dispose()Dispose(بول)
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
هل ينبغي تخصيص الموارد التي يتم إدارةها؟
Extract(الستار)
استخراج الأرشيف إلى الملف عن طريق الطريق.
public FileInfo Extract(string path)Parameters
path string
المسار إلى الملف المستهدف.إذا كان الملف موجودًا بالفعل ، فسيتم إعادة كتابته.
Returns
معلومات عن ملف استخراج.
Exceptions
إن تدفق المصدر قصير جدًا.
بيوت خاطئة تم العثور عليها أثناء التشفير.
هذا الإصدار LZ4 غير مدعوم.
Extract(Stream)
استخراج الأرشيف إلى التدفق المقدم.
public void Extract(Stream destination)Parameters
destination Stream
كلمات مفتاحية يجب أن تكون مكتوبة
Examples
using (var archive = new Lz4Archive("archive.lz4"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
إن تدفق المصدر قصير جدًا.
بيوت خاطئة تم العثور عليها أثناء التشفير.
هذا الإصدار LZ4 غير مدعوم.
يتم إعداد الأرشيف للتركيب.
ExtractToDirectory(الستار)
استخراج محتوى الأرشيف إلى الدليل المقدم.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
الطريق إلى الدليل لوضع الملفات المستخرجة في.
Remarks
إذا لم يكن الدليل موجودًا ، فسيتم إنشاؤه.
Exceptions
destinationDirectory’ is null.
على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرف، وأسماء الملفات يجب أن تكون أقل من 260 حرف.
لا يتمتع المكالمة بالترخيص المطلوب للوصول إلى الدليل الحالي.
إذا لم يكن الدليل موجودًا ، فإن المسار يحتوي على حرف العمود الفقري (:) الذي ليس جزءًا من علامة محرك الأقراص (“C:”).
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 (:).
المجلد المحدد بالطريق هو ملف. -أو- اسم الشبكة غير معروف.
إن تدفق المصدر قصير جدًا.
تم العثور على بايتات خاطئة أثناء بدء التشفير.
يتم إعداد الأرشيف للتركيب.
Open()
يفتح الأرشيف للاستخراج ويقدم تدفقًا مع محتوى الأرشيف.
public Stream Open()Returns
الشبكة التي تمثل محتويات الأرشيف.
Examples
استخراج الأرشيف ونسخ المحتوى المستخرج إلى تدفق الملفات.
using (var archive = new Lz4Archive("archive.lz4"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}ويمكنك استخدام طريقة Stream.CopyTo لـ .NET 4.0 أو أعلى: unpacked.KopiTo(مستخرج)؛
Remarks
اقرأ من البث للحصول على المحتوى الأصلي للملف.
Exceptions
إن تدفق المصدر قصير جدًا.
تم العثور على بايتات خاطئة أثناء بدء التشفير.
يتم إعداد الأرشيف للتركيب.
Save(Stream)
توفير الأرشيف lz4 إلى التدفق المقدمة.
public void Save(Stream output)Parameters
output Stream
النطاق المستهدف
Examples
using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save(lz4File);
}
}Remarks
يجب أن تكون قابلة للبحث.
Exceptions
output’ is null.
output’ is not writable.
يتم إعداد الأرشيف للاستخراج. - أو - لم يتم توفير المصدر.
Save(FileInfo)
حفظ الأرشيف lz4 إلى ملف الوجهة المقدمة.
public void Save(FileInfo destination)Parameters
destination FileInfo
FileInfo، والتي سيتم فتحها كدفق الوجهة.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz4"));
}Exceptions
لا يحصل المتصل على السماح المطلوب لفتح destination".
مسار الملف فارغ أو يحتوي فقط على مساحات بيضاء.
لم يتم العثور على الملف.
الطريق إلى الملف هو القراءة فقط أو هو دليل.
destination’ is null.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
يتم إعداد الأرشيف للاستخراج.
Save(الستار)
حفظ الأرشيف إلى ملف الوجهة المقدمة.
public void Save(string destinationFileName)Parameters
destinationFileName string
إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم إعادة كتابته.
Examples
using (var archive = new LZ4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}Exceptions
destinationFileName’ is null.
لا يتمتع المستخدم بالترخيص المطلوب للوصول إلى
الوجه destinationFileName’ فارغ ، يحتوي فقط على مساحات بيضاء ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف destinationFileName'.
المحدد destinationFileName، اسم الملف، أو كلاهما يتجاوز الحد الأقصى الذي يحدده النظام.على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرفا، وأسماء الملفات يجب أن تكون أقل من 260 حرفا.
ملف في destinationFileName’ يحتوي على عمود (:) في منتصف السلسلة.
يتم إعداد الأرشيف للاستخراج.
SetSource(Stream)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(Stream source)Parameters
source Stream
تدفق الدخول إلى الأرشيف.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz4");
}Exceptions
يتم إعداد الأرشيف للاستخراج.
SetSource(FileInfo)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
الإشارة إلى ملف يتم ضغطه.
Examples
افتح أرشيفًا من تدفق واستخراجها إلى
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz4");
}Exceptions
يتم إعداد الأرشيف للاستخراج.
SetSource(أرشيف الوسم : TarFormat)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)Parameters
tarArchive TarArchive
أرشيف تار للضغط.
format TarFormat
تعريف تار العنوان تنسيق.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var lz4Archive = new Lz4Archive())
{
lz4Archive.SetSource(tarArchive);
lz4Archive.Save("archive.tar.lz4");
}
}Remarks
استخدم هذه الطريقة لتكوين الأرشيف المشترك tar.lz4.
SetSource(الستار)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(string path)Parameters
path string
الطريق إلى التسجيل لتكون مضغوطة.
Examples
افتح ملفًا من الملف حسب الطريق واستخراجها إلى
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}Exceptions
path’ is null.
لا يتمتع المستخدم بالترخيص المطلوب للوصول إلى
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
هذه الأرشيفات مستعدة للاستخراج.
