Class Bzip2Archive

Class Bzip2Archive

Tên không gian: Aspose.Zip.Bzip2 Tổng hợp: Aspose.Zip.dll (25.5.0)

Lớp này đại diện cho tệp lưu trữ bzip2. sử dụng nó để tạo hoặc rút các tệp lưu trữ bzip2.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Bzip2Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Thành viên thừa kế

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

bzip2 nén tệp bằng cách sử dụng block Burrows-Wheeler sorting text compression algorithm, và Huffman coding. Xem thêm: https://en.wikipedia.org/wiki/Bzip2

Constructors

Bzip2Archive()

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Bzip2.Bzip2Archive chuẩn bị để nén.

public Bzip2Archive()

Examples

Ví dụ sau đây cho thấy làm thế nào để nén một tệp.

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

Bzip2Archive(Tải về Bzip2LoadOptions)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Bzip2.Bzip2Archive chuẩn bị để giảm bớt.

public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)

Parameters

sourceStream Stream

Nguồn gốc của Archive.

loadOptions Bzip2LoadOptions

Các tùy chọn để tải file với.

Examples

Mở một tập tin từ một dòng và rút nó vào một

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
  archive.Open().CopyTo(ms);

Remarks

Xem Aspose.Zip.Bzip2.Bzip2Archive.Open phương pháp để giảm bớt.

Exceptions

EndOfStreamException

Kết thúc dòng chảy sớm

InvalidDataException

chữ ký byte sai.

Bzip2Archive(Tính năng: Bzip2LoadOptions)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Bzip2.Bzip2Archive chuẩn bị để giảm bớt.

public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)

Parameters

path string

Cách di chuyển đến file file.

loadOptions Bzip2LoadOptions

Các tùy chọn để tải file với.

Examples

Mở một tập tin từ tệp theo con đường và rút nó vào một

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
  archive.Open().CopyTo(ms);

Remarks

Xem Aspose.Zip.Bzip2.Bzip2Archive.Open phương pháp để giảm bớt.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập.

ArgumentException

Đường path’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

Truy cập vào tệp path" bị từ chối.

PathTooLongException

Lối đi path", tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, các con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

Tệp ở path’ chứa một cột (:) ở giữa dòng.

FileNotFoundException

file không được tìm thấy.

DirectoryNotFoundException

Con đường được chỉ định là vô hiệu, chẳng hạn như ở trên một ổ đĩa không được vẽ.

IOException

Tệp đã mở rồi.

EndOfStreamException

Kết thúc dòng chảy sớm

InvalidDataException

chữ ký byte sai.

Methods

Dispose()

Thực hiện các nhiệm vụ được xác định theo ứng dụng liên quan đến việc giải phóng, giải phóng hoặc tái quản lý các tài nguyên không được quản lý.

public void Dispose()

Dispose(Bool)

Thực hiện các nhiệm vụ được xác định theo ứng dụng liên quan đến việc giải phóng, giải phóng hoặc tái quản lý các tài nguyên không được quản lý.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Liệu các tài nguyên được quản lý có nên được khai thác hay không.

Extract(Stream)

Tải lưu trữ vào dòng được cung cấp.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. phải được viết.

Examples

using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

Extract(String)

Tiết xuất tài liệu vào tệp theo con đường.

public FileInfo Extract(string path)

Parameters

path string

Đường đến tập tin đích. nếu tập tin đã tồn tại, nó sẽ được viết quá.

Returns

FileInfo

Thông tin về các tập tin được rút ra.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập.

ArgumentException

Đường path’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

Truy cập vào tệp path" bị từ chối.

PathTooLongException

Lối đi path", tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, các con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

Tệp ở path’ chứa một cột (:) ở giữa dòng.

FileNotFoundException

file không được tìm thấy.

DirectoryNotFoundException

Con đường được chỉ định là vô hiệu, chẳng hạn như ở trên một ổ đĩa không được vẽ.

IOException

Tệp đã mở rồi.

ExtractToDirectory(String)

Thu thập nội dung của lưu trữ vào thư mục được cung cấp.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Con đường đến thư mục để đặt các tập tin được lấy vào.

Remarks

Nếu thư mục không tồn tại, nó sẽ được tạo ra.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Các con đường cụ thể, tên tệp hoặc cả hai đều vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, con đường phải nhỏ hơn 248 ký tự và tên tệp phải nhỏ hơn 260 ký tự.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập thư mục hiện có.

NotSupportedException

Nếu thư mục không tồn tại, con đường chứa một ký tự vỏ (:) không phải là một phần của một nhãn ổ đĩa (“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

Danh mục được chỉ định theo con đường là một tệp. -or- Tên mạng không được biết.

Open()

Mở lưu trữ để khai thác và cung cấp một dòng với nội dung lưu trữ.

public Stream Open()

Returns

Stream

dòng mà đại diện cho nội dung của lưu trữ.

Examples

Sử dụng :Stream decompressed = archive.Open();

.NET 4.0 và cao hơn - sử dụng phương pháp Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 và trước - sao chép byte bằng tay:

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

Destination dòng

saveOptions Bzip2SaveOptions

Các tùy chọn để lưu một tập tin bzip2. nếu không được xác định, kích thước khối 900 Kb sẽ được sử dụng.

Examples

Viết dữ liệu nén vào dòng phản ứng http.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Remarks

phải có thể viết.

Exceptions

InvalidOperationException

Nguồn dữ liệu để lưu trữ chưa được cung cấp.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

Nguồn tệp chỉ được đọc hoặc là một thư mục.

DirectoryNotFoundException

Đường nguồn tệp được chỉ định là vô hiệu, chẳng hạn như đang ở trên một ổ đĩa không được vẽ.

IOException

Nguồn file đã mở.

Save(Tính năng: Bzip2SaveOptions)

Tiết kiệm lưu trữ đến một tập tin đích được cung cấp.

public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)

Parameters

destinationFileName string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

saveOptions Bzip2SaveOptions

Các tùy chọn để lưu một tập tin bzip2. nếu không được xác định, kích thước khối 900 Kb sẽ được sử dụng.

Examples

Viết dữ liệu nén vào file.

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập.

ArgumentException

destinationFileName’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

Truy cập vào tệp destinationFileName’ bị từ chối.

PathTooLongException

Mục đích destinationFileName’, tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

File tại destinationFileName’ chứa một cột (:) ở giữa dòng.

SetSource(Stream)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(Stream source)

Parameters

source Stream

dòng nhập vào lưu trữ.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
    archive.Save("archive.bz2");
}

SetSource(FileInfo)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Các tham chiếu đến một tệp để được nén.

Examples

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

SetSource(String)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(string path)

Parameters

path string

Cách để file để được nén.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập.

ArgumentException

Đường path’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

Truy cập vào tệp path" bị từ chối.

PathTooLongException

Lối đi path", tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, các con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

Tệp ở path’ chứa một cột (:) ở giữa dòng.

SetSource(Trang chủ, TarFormat)

Đặt nội dung để được nén trong hồ sơ.

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

Parameters

tarArchive TarArchive

Tài liệu Tar để được nén.

format TarFormat

Định nghĩa Tar Header Format.

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

Sử dụng phương pháp này để kết hợp tập tin tar.bz2 chung.

SetSource(CpioArchive, CpioFormat)

Đặt nội dung để được nén trong hồ sơ.

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

Parameters

cpioArchive CpioArchive

Cpio lưu trữ để được nén.

format CpioFormat

Định dạng 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

Sử dụng phương pháp này để kết hợp tập tin cpio.bz2 chung.

 Tiếng Việt