Class ZstandardArchive

path là null.

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

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

Quyền truy cập vào tệp path bị từ chối.

path, tên tệp, hoặc cả hai vượt quá chiều dài tối đa được hệ thống xác định. Ví dụ, trên các nền tảng Windows, đườ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 path chứa dấu hai chấm (:) ở giữa chuỗi.

Các phương thức

Dispose()

Thực hiện các tác vụ được xác định bởi ứng dụng liên quan đến việc giải phóng, phát hành 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ụ được xác định bởi ứng dụng liên quan đến việc giải phóng, phát hành 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 được quản lý có nên được giải phóng hay không.

Extract(Stream)

Giải nén lưu trữ vào luồng được cung cấp.

public void Extract(Stream destination)

Tham số

destination Stream

Luồng đích. Phải có thể ghi.

Ví dụ

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

Ngoại lệ

destination không hỗ trợ ghi.

Extract(string)

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

public FileInfo Extract(string path)

Tham số

path string

Đường dẫn đến tệp đích. Nếu tệp đã tồn tại, nó sẽ bị ghi đè.

Trả về

FileInfo

Thông tin về tệp đã giải nén.

Ngoại lệ

path là null.

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

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

Quyền truy cập vào tệp path bị từ chối.

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

ExtractToDirectory(string)

Giải nén nội dung của lưu trữ vào thư mục đượ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.

path, tên tệp, hoặc cả hai vượt quá chiều dài tối đa được hệ thống xác định. Ví dụ, trên các nền tảng Windows, đườ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 truy cập cần thiết vào thư mục hiện có.

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

destinationDirectory là chuỗi độ dài bằng không, chỉ chứa 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, ký tự dấu hai chấm (:).

IOException

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.

Open()

Mở lưu trữ để giải nén và cung cấp một luồng với nội dung lưu trữ.

public Stream Open()

Trả về

Stream

Luồng đại diện cho nội dung của lưu trữ.

Ví dụ

Giải nén lưu trữ và sao chép nội dung đã giải nén vào luồng tệp.

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Bạn có thể sử dụng phương thức Stream.CopyTo cho .NET 4.0 trở lên: `unpacked.CopyTo(extracted);`

Nhận xét

Đọc từ luồng để lấy nội dung gốc của tệp. Xem phần ví dụ.

Save(Stream, ZstandardSaveOptions)

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

Tham số

outputStream Stream

Luồng đích.

settings ZstandardSaveOptions

Các tùy chọn cho việc tạo lưu trữ.

Ví dụ

Ghi dữ liệu nén vào luồng phản hồi http.

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

Nhận xét

outputStream phải có thể ghi.

Ngoại lệ

InvalidOperationException

outputStream không thể ghi.

Nguồn chưa được cung cấp.

Save(string, ZstandardSaveOptions)

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

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

Tham số

destinationFileName string

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

settings ZstandardSaveOptions

Các tùy chọn cho việc tạo lưu trữ.

Ví dụ

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

Ngoại lệ

destinationFileName là null.

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

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

Quyền truy cập vào tệp destinationFileName bị từ chối.

destinationFileName, tên tệp, hoặc cả hai vượt quá chiều dài tối đa được hệ thống xác định. Ví dụ, trên các nền tảng Windows, đườ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 dấu hai chấm (:) ở giữa chuỗi.

Save(FileInfo, ZstandardSaveOptions)

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

Tham số

destination FileInfo

FileInfo sẽ được mở dưới dạng luồng đích.

settings ZstandardSaveOptions

Các tùy chọn cho việc tạo lưu trữ.

Ví dụ

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

Ngoại lệ

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

Đường dẫn tệp rỗng hoặc chỉ chứa khoảng trắng.

FileNotFoundException

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

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

DirectoryNotFoundException

destination 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ạ.

IOException

Tệp đã được mở.

SetSource(Stream)

Thiết lập 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 ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

SetSource(FileInfo)

Thiết lập nội dung sẽ được nén trong lưu trữ.

public void SetSource(FileInfo fileInfo)

Tham số

fileInfo FileInfo

Tham chiếu đến một tệp sẽ được nén.

Ví dụ

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

SetSource(string)

Thiết lập nội dung sẽ được nén trong lưu trữ.

public void SetSource(string path)

Tham số

path string

Đường dẫn đến tệp sẽ được nén.

Ví dụ

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

Ngoại lệ

path là null.

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

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

Quyền truy cập vào tệp path bị từ chối.