Class Bzip2Archive

Class Bzip2Archive

نام ها : Aspose.Zip.Bzip2 جمع آوری: Aspose.Zip.dll (25.5.0)

این کلاس فایل آرشیو bzip2 را نشان می دهد.با استفاده از آن برای ترکیب یا استخراج آرشیو bzip2.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ← Bzip2Archive

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 کدگذاری. بیشتر ببینید: https://en.wikipedia.org/wiki/Bzip2

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

EndOfStreamException

پایان جریان زودهنگام

InvalidDataException

بایت های اشتباه امضا

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

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

دسترسی به فایل path" رد می شود.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

FileNotFoundException

این فایل یافت نشد.

DirectoryNotFoundException

مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.

IOException

فایل در حال حاضر باز است.

EndOfStreamException

پایان جریان زودهنگام

InvalidDataException

بایت های اشتباه امضا

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

ArgumentException

destination’ does not support writing.

Extract(String)

آرشیو را از طریق مسیر به فایل اضافه کنید.

public FileInfo Extract(string path)

Parameters

path string

مسیر به مقصد فایل.اگر فایل در حال حاضر وجود دارد، آن را بیش از حد نوشته خواهد شد.

Returns

FileInfo

اطلاعات مربوط به فایل های استخراج شده

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

دسترسی به فایل path" رد می شود.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

FileNotFoundException

این فایل یافت نشد.

DirectoryNotFoundException

مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.

IOException

فایل در حال حاضر باز است.

ExtractToDirectory(String)

محتوای آرشیو را به دایرکتوری ارائه شده استخراج کنید.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

مسیر به دایرکتوری برای قرار دادن فایل های استخراج شده در.

Remarks

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.

NotSupportedException

اگر دایرکتوری وجود ندارد، مسیر حاوی یک کاراکتر ستون فقرات (:) است که بخشی از یک برچسب درایو نیست (“C:”).

ArgumentException

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 (:).

IOException

دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.

Open()

آرشیو را برای استخراج باز می کند و جریان با محتوای آرشیو را فراهم می کند.

public Stream Open()

Returns

Stream

جریان که محتوای آرشیو را نشان می دهد.

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

InvalidOperationException

منبع اطلاعاتی که باید ذخیره شود، ارائه نشده است.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

منبع فایل فقط خوانده شده است یا یک دایرکتوری است.

DirectoryNotFoundException

مسیر منبع فایل مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه برداری.

IOException

منبع فایل در حال حاضر باز است.

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه

UnauthorizedAccessException

دسترسی به فایل destinationFileName’ رد می شود.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در 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(String)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(string path)

Parameters

path string

راهی برای فشرده سازی است.

Examples 

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

دسترسی به فایل path" رد می شود.

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

SetSource(بایگانی برچسب ها: TarFormat)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

آرشیو برای فشرده سازی

format TarFormat

مشخص کردن فرمت Tar Header

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(بایگانی برچسب ها: CpioFormat)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)

Parameters

cpioArchive CpioArchive

آرشیو برای فشرده سازی

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 استفاده کنید.

 فارسی