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
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
Kết thúc dòng chảy sớm
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
path’ is null.
Người gọi không có giấy phép cần thiết để truy cập.
Đườ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.
Truy cập vào tệp path" bị từ chối.
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ự.
Tệp ở path’ chứa một cột (:) ở giữa dòng.
file không được tìm thấy.
Con đường được chỉ định là vô hiệu, chẳng hạn như ở trên một ổ đĩa không được vẽ.
Tệp đã mở rồi.
Kết thúc dòng chảy sớm
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
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
Thông tin về các tập tin được rút ra.
Exceptions
path’ is null.
Người gọi không có giấy phép cần thiết để truy cập.
Đườ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.
Truy cập vào tệp path" bị từ chối.
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ự.
Tệp ở path’ chứa một cột (:) ở giữa dòng.
file không được tìm thấy.
Con đường được chỉ định là vô hiệu, chẳng hạn như ở trên một ổ đĩa không được vẽ.
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
destinationDirectory’ is null.
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ự.
Người gọi không có giấy phép cần thiết để truy cập thư mục hiện có.
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:”).
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 (:).
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
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
Nguồn dữ liệu để lưu trữ chưa được cung cấp.
outputStream’ is not writable.
Nguồn tệp chỉ được đọc hoặc là một thư mục.
Đườ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ẽ.
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
destinationFileName’ is null.
Người gọi không có giấy phép cần thiết để truy cập.
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.
Truy cập vào tệp destinationFileName’ bị từ chối.
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ự.
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
path’ is null.
Người gọi không có giấy phép cần thiết để truy cập.
Đườ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.
Truy cập vào tệp path" bị từ chối.
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ự.
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.