Class ZstandardArchive

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.

`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 (var archive = new GzipArchive("archive.zst"))
{
     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`

FileInfo

Thông tin về một 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.

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

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

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`

Loại bỏ các tập tin và sao chép nội dung được lấy vào file stream.

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 pháp Stream.CopyTo cho .NET 4.0 và cao hơn: ‘unpacked.Kopy To(từ);’

`Remarks`

Đọc từ dòng để có được nội dung ban đầu của một tệp. Xem phần ví dụ.

`Save(Stream, ZstandardSaveOptions)`

Tiết kiệm lưu trữ cho dòng cung cấp.

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

`Parameters`

outputStream Stream

Destination dòng

settings ZstandardSaveOptions

Cài đặt tùy chọn cho thành phần lưu trữ.

`Examples`

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

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

`Remarks`

phải có thể viết.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Nguồn không được cung cấp.

`Save(Tính năng: ZstandardSaveOptions)`

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

public void Save(string destinationFileName, ZstandardSaveOptions settings = 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á.

settings ZstandardSaveOptions

Cài đặt tùy chọn cho thành phần lưu trữ.

`Examples`

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

`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.

`Save(FileInfo và ZstandardSaveOptions)`

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

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

`Parameters`

destination FileInfo

FileInfo, sẽ được mở như là dòng đích.

settings ZstandardSaveOptions

Cài đặt tùy chọn cho thành phần lưu trữ.

`Examples`

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

`Exceptions`

Người gọi không có quyền được yêu cầu để mở destination".

Đường file là trống hoặc chỉ chứa không gian trắng.

FileNotFoundException

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

Con đường đến file là chỉ đọc hoặc là một thư mục.

DirectoryNotFoundException

destination’ is null.

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.

`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 (var archive = new ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

`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 (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.zst");
}

`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 (var archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

`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.