Class Bzip2Archive
اسم الفضاء : Aspose.Zip.Bzip2 تجميع: Aspose.Zip.dll (25.5.0)
هذه الفئة تمثل ملف الأرشيف bzip2.استخدمها لتكوين أو استخراج أرشيف bzip2.
public class Bzip2Archive : 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()
Remarks
bzip2 يضغط على الملفات باستخدام الكتلة Burrows-Wheeler تصنيف النص التركيز الخوارزمي، و Huffman التركيز.
Constructors
Bzip2Archive()
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Bzip2.Bzip2Archive المعدة للضغط.
public Bzip2Archive()Examples
يظهر المثال التالي كيفية ضغط ملف.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Bzip2Archive(البريد الإلكتروني Bzip2LoadOptions)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Bzip2.Bzip2Archive مستعدة للتخفيف.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)Parameters
sourceStream Stream
مصدر الأرشيف .
loadOptions Bzip2LoadOptions
خيارات تحميل الأرشيف مع.
Examples
افتح أرشيفًا من تدفق واستخراجها إلى
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);Remarks
هذا البناء لا يخفف. انظر Aspose.Zip.Bzip2.Bzip2Archive.Open طريقة للتخفيف.
Exceptions
انتهاء التدفق المبكر.
خطأ في توقيع بايت
Bzip2Archive(أضف تعليق حول Bzip2LoadOptions)
يبدأ مثالًا جديدًا من فئة Aspose.Zip.Bzip2.Bzip2Archive مستعدة للتخفيف.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)Parameters
path string
الطريق إلى ملف الأرشيف.
loadOptions Bzip2LoadOptions
خيارات تحميل الأرشيف مع.
Examples
افتح ملفًا من الملف حسب الطريق واستخراجها إلى
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);Remarks
هذا البناء لا يخفف. انظر Aspose.Zip.Bzip2.Bzip2Archive.Open طريقة للتخفيف.
Exceptions
path’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
انتهاء التدفق المبكر.
خطأ في توقيع بايت
Methods
Dispose()
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
public void Dispose()Dispose(بول)
يمارس المهام المحددة في التطبيق المرتبطة بتفريغ أو إطلاق أو إعادة تدوير الموارد غير المعالجة.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
هل ينبغي تخصيص الموارد التي يتم إدارةها؟
Extract(Stream)
استخراج الأرشيف إلى التدفق المقدم.
public void Extract(Stream destination)Parameters
destination Stream
كلمات مفتاحية يجب أن تكون مكتوبة
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(الستار)
استخراج الأرشيف إلى الملف عن طريق الطريق.
public FileInfo Extract(string path)Parameters
path string
المسار إلى الملف المستهدف.إذا كان الملف موجودًا بالفعل ، فسيتم إعادة كتابته.
Returns
معلومات عن الملف المستخرج.
Exceptions
path’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
لم يتم العثور على الملف.
المسار المحدد غير صالح ، على سبيل المثال ، على محرك أقراص غير مسجلة.
الملف مفتوح بالفعل.
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
الاستخدام :Stream decompressed = archive.Open();
.NET 4.0 أو أعلى - استخدم طريقة Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 وما قبلها - نسخ بايتات يدويا:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Remarks
Read from the stream to get the original content of the file. See examples section.
### <a id="Aspose_Zip_Bzip2_Bzip2Archive_Save_System_IO_Stream_Aspose_Zip_Bzip2_Bzip2SaveOptions_"></a> Save\(Stream, Bzip2SaveOptions\)
Saves archive to the stream provided.
```csharp
public void Save(Stream outputStream, Bzip2SaveOptions saveOptions = null)Parameters
outputStream Stream
النطاق المستهدف
saveOptions Bzip2SaveOptions
خيارات لتخزين ملف bzip2.إذا لم يتم تحديد حجم الكتلة 900 كيلو بايت سيتم استخدامها.
Examples
اكتب البيانات المضغوطة إلى تدفق استجابة http.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
يجب أن تكون مكتوبة.
Exceptions
لم يتم توفير مصدر البيانات المخزنة.
outputStream’ is not writable.
مصدر الملف هو مجرد قراءة أو هو دليل.
مسار مصدر الملف المحدد غير صالح، على سبيل المثال، على محرك أقراص غير مسجلة.
مصدر الملفات مفتوح بالفعل
Save(أضف تعليق حول Bzip2SaveOptions)
حفظ الأرشيف إلى ملف الوجهة المقدمة.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)Parameters
destinationFileName string
إذا كان اسم الملف المحدد يشير إلى ملف موجود ، فسيتم إعادة كتابته.
saveOptions Bzip2SaveOptions
خيارات لتخزين ملف bzip2.إذا لم يتم تحديد حجم الكتلة 900 كيلو بايت سيتم استخدامها.
Examples
كتابة البيانات المضغوطة إلى الملف.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}Exceptions
destinationFileName’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الوجه destinationFileName’ فارغ ، يحتوي فقط على مساحات بيضاء ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف destinationFileName'.
المحدد destinationFileName، اسم الملف، أو كلاهما يتجاوز الحد الأقصى الذي يحدده النظام.على سبيل المثال، على منصات ويندوز، يجب أن تكون المسارات أقل من 248 حرفا، وأسماء الملفات يجب أن تكون أقل من 260 حرفا.
ملف في destinationFileName’ يحتوي على عمود (:) في منتصف السلسلة.
SetSource(Stream)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(Stream source)Parameters
source Stream
تدفق الدخول إلى الأرشيف.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}SetSource(FileInfo)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
الإشارة إلى ملف يتم ضغطه.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}SetSource(الستار)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(string path)Parameters
path string
الطريق إلى التسجيل لتكون مضغوطة.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Exceptions
path’ is null.
لا يحصل المتصل على إذن الوصول المطلوب.
الطريق " فارغ ، يحتوي على مساحات بيضاء فقط ، أو يحتوي على أحرف غير صحيحة.
يتم رفض الوصول إلى ملف path".
على سبيل المثال ، على المنصات المستندة إلى Windows ، يجب أن تكون المسارات أقل من 248 حرفًا ، ويجب أن يكون اسم الملف أقل من 260 حرفًا.
ملف في path’ يحتوي على عمود (:) في وسط السلسلة.
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 bzippedArchive = new Bzip2Archive())
{
bzippedArchive.SetSource(tarArchive);
bzippedArchive.Save("archive.tar.bz2");
}
}Remarks
استخدم هذه الطريقة لتكوين ملف tar.bz2 المشترك.
SetSource(CpioArchive، CpioFormat)
وضع المحتوى للضغط داخل الأرشيف.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)Parameters
cpioArchive CpioArchive
أرشيف Cpio للضغط.
format CpioFormat
تحديد شكل cpio header.
Examples
using (var cpioArchive = new CpioArchive())
{
cpioArchive.CreateEntry("first.bin", "data1.bin");
cpioArchive.CreateEntry("second.bin", "data2.bin");
using (var bzippedArchive = new Bzip2Archive())
{
bzippedArchive.SetSource(cpioArchive);
bzippedArchive.Save("archive.cpio.bz2");
}
}Remarks
استخدم هذه الطريقة لتكوين ملف cpio.bz2 المشترك.
