Class ZArchive

source không thể tìm kiếm.

source là null.

ZArchive(string, ZArchiveLoadOptions)

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Z.ZArchive được chuẩn bị để giải nén.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Tham số

path string

Đường dẫn đến nguồn của lưu trữ.

loadOptions ZArchiveLoadOptions

Các tùy chọn để tải lưu trữ.

Nhận xét

Hàm khởi tạo này không giải nén. Xem phương thức Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) để giải nén.

Ngoại lệ

path là null.

Người gọi không có quyền cần thiết để truy cập.

path là trống, chỉ chứa các khoảng trắng, hoặc chứa các ký tự không hợp lệ.

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

path, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng dựa trên Windows, các đường dẫn phải ngắn hơn 248 ký tự và tên tệp phải ngắn hơn 260 ký tự.

DirectoryNotFoundException

Tệp tại path chứa một dấu hai chấm (:) ở giữa chuỗi.

FileNotFoundException

Tệp không được tìm thấy.

Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.

Tệp đã mở.

Phương thức

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

Tham số

disposing bool

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

Extract(Stream)

Giải nén lưu trữ Z vào một luồng.

public void Extract(Stream destination)

Tham số

destination Stream

Luồng để lưu trữ dữ liệu đã giải nén.

Ví dụ

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Ngoại lệ

InvalidDataException

Dữ liệu không thể được giải nén.

Extract(FileInfo)

Giải nén lưu trữ Z vào một tệp.

public void Extract(FileInfo fileInfo)

Tham số

fileInfo FileInfo

FileInfo để lưu trữ dữ liệu đã giải nén.

Ví dụ

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Ngoại lệ

Người gọi không có quyền cần thiết để mở fileInfo.

Đường dẫn tệp là trống hoặc chỉ chứa các khoảng trắng.

FileNotFoundException

Tệp không được tìm thấy.

Đường dẫn đến tệp chỉ đọc hoặc là một thư mục.

DirectoryNotFoundException

fileInfo là null.

Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.

Tệp đã mở.

InvalidDataException

Dữ liệu không thể được giải nén.

Extract(string)

Giải nén lưu trữ Z vào một tệp theo đường dẫn.

public FileInfo Extract(string path)

Tham số

path string

Đường dẫn đến tệp sẽ lưu trữ dữ liệu đã giải nén.

Trả về

FileInfo

Thông tin của tệp đã giải nén.

Ví dụ

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Ngoại lệ

path là null.

Người gọi không có quyền cần thiết để truy cập.

path là trống, chỉ chứa các khoảng trắng, hoặc chứa các ký tự không hợp lệ.

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

Tệp tại path chứa một dấu hai chấm (:) ở giữa chuỗi.

InvalidDataException

Dữ liệu không thể được giải nén.

ExtractToDirectory(string)

Giải nén nội dung của lưu trữ vào thư mục đã cung cấp.

public void ExtractToDirectory(string destinationDirectory)

Tham số

destinationDirectory string

Đường dẫn đến thư mục để đặt các tệp đã giải nén.

Nhận xét

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

Ngoại lệ

destinationDirectory là null.

Đường dẫn được chỉ định, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng dựa trên Windows, các đường dẫn phải ngắn hơn 248 ký tự và tên tệp phải ngắn hơn 260 ký tự.

Người gọi không có quyền cần thiết để truy cập thư mục hiện có.

Nếu thư mục không tồn tại, đường dẫn chứa một ký tự dấu hai chấm (:) không phải là một phần của nhãn ổ đĩa (“C:").

destinationDirectory là một chuỗi có độ dài bằng không, chỉ chứa các khoảng trắng, hoặc chứa một hoặc nhiều ký tự không hợp lệ. Bạn có thể kiểm tra các ký tự không hợp lệ bằng cách sử dụng phương thức System.IO.Path.GetInvalidPathChars. -hoặc- đường dẫn được tiền tố bằng, hoặc chỉ chứa, một ký tự dấu hai chấm (:).

Thư mục được chỉ định bởi đường dẫn là một tệp. -hoặc- Tên mạng không được biết đến.

Save(Stream, ZArchiveSaveOptions)

Lưu lưu trữ xz vào luồng đã cung cấp.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Tham số

output Stream

Luồng đích.

settings ZArchiveSaveOptions

Tùy chọn thiết lập cho việc tạo lưu trữ.

Ví dụ

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Nhận xét

output phải có thể tìm kiếm.

Ngoại lệ

output không hỗ trợ tìm kiếm.

output là null.

Save(string, ZArchiveSaveOptions)

Lưu lưu trữ Z vào tệp đích đã cung cấp.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Tham số

destinationFileName string

+Đường dẫn của lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

settings ZArchiveSaveOptions

Tùy chọn thiết lập cho việc tạo lưu trữ.

Ví dụ

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

Ngoại lệ

destinationFileName là null.

Người gọi không có quyền cần thiết để truy cập.

destinationFileName là trống, chỉ chứa các khoảng trắng, hoặc chứa các ký tự không hợp lệ.

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

destinationFileName, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng dựa trên Windows, các đường dẫn phải ngắn hơn 248 ký tự và tên tệp phải ngắn hơn 260 ký tự.

Tệp tại destinationFileName chứa một dấu hai chấm (:) ở giữa chuỗi.

SetSource(Stream)

Đặt nội dung sẽ được nén trong lưu trữ.

public void SetSource(Stream source)

Tham số

source Stream

Luồng đầu vào cho lưu trữ.

Ví dụ

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

SetSource(FileInfo)

Đặt nội dung sẽ được nén trong lưu trữ.

public void SetSource(FileInfo fileInfo)

Tham số

fileInfo FileInfo

FileInfo sẽ được mở như luồng đầu vào.

Ví dụ

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

Ngoại lệ

Người gọi không có quyền cần thiết để mở fileInfo.

Đường dẫn tệp là trống hoặc chỉ chứa các khoảng trắng.

FileNotFoundException

Tệp không được tìm thấy.

Đường dẫn đến tệp chỉ đọc hoặc là một thư mục.

DirectoryNotFoundException

fileInfo là null.

Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.

Tệp đã mở.

SetSource(string)

Đặt nội dung sẽ được nén trong lưu trữ.

public void SetSource(string sourcePath)

Tham số

sourcePath string

Đường dẫn đến tệp sẽ được mở như luồng đầu vào.

Ví dụ

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

Ngoại lệ

sourcePath là null hoặc chuỗi rỗng.

Người gọi không có quyền cần thiết để truy cập một tài nguyên.

sourcePath là trống, chỉ chứa các khoảng trắng, hoặc chứa các ký tự không hợp lệ.

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

sourcePath, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng dựa trên Windows, các đường dẫn phải ngắn hơn 248 ký tự và tên tệp phải ngắn hơn 260 ký tự.