Class ZstandardArchive

Panggilan tidak memiliki izin yang diperlukan untuk mengakses.

path’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah.

Akses ke file path’ ditolak.

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

File di path’ mengandung kolom (:) di tengah string.

`Methods`

`Dispose()`

Melaksanakan tugas-tugas yang ditentukan oleh aplikasi yang terkait dengan pembebasan, pembebasan, atau reset sumber daya yang tidak dikelola.

public void Dispose()

`Dispose(Bool)`

Melaksanakan tugas-tugas yang ditentukan oleh aplikasi yang terkait dengan pembebasan, pembebasan, atau reset sumber daya yang tidak dikelola.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Apakah sumber daya yang dikelola harus dihapus.

`Extract(Stream)`

Mengekstrak arkib ke arus yang disediakan.

public void Extract(Stream destination)

`Parameters`

destination Stream

Destination stream. harus dapat ditulis.

`Examples`

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

`Exceptions`

destination’ does not support writing.

`Extract(String)`

Mengekstrak file ke file dengan jalur.

public FileInfo Extract(string path)

`Parameters`

path string

Jika file sudah ada, akan dituliskannya.

`Returns`

FileInfo

Informasi dari file yang dikeluarkan.

`Exceptions`

path’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses.

path’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah.

Akses ke file path’ ditolak.

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

File di path’ mengandung kolom (:) di tengah string.

`ExtractToDirectory(String)`

Mengekstrak konten dari arkib ke direktori yang disediakan.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Jalan menuju direktori untuk menempatkan file yang dikeluarkan.

`Remarks`

Jika direktori tidak ada, itu akan dibuat.

`Exceptions`

destinationDirectory’ is null.

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter dan nama file harus kurang dari 260 karakter.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses direktori yang ada.

Jika direktori tidak ada, jalur ini mengandung karakter kolon (:) yang bukan bagian dari label drive (“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

Direktori yang ditentukan oleh jalur adalah file. -or- Nama jaringan tidak diketahui.

`Open()`

Buka arkib untuk ekstraksi dan memberikan arus dengan konten arkib.

public Stream Open()

`Returns`

Stream

aliran yang mewakili konten dari arkib.

`Examples`

Mengekstrak arsip dan menyalin konten yang dikeluarkan ke 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);
    }            
}

Anda dapat menggunakan metode Stream.CopyTo untuk .NET 4.0 dan lebih tinggi: unpacked.KopiTo(ekstrak);

`Remarks`

Baca dari aliran untuk mendapatkan konten asli dari file. lihat contoh bagian.

`Save(Stream dan ZstandardSaveOptions)`

Simpan file ke arus yang disediakan.

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

`Parameters`

outputStream Stream

Destinasi dari Stream.

settings ZstandardSaveOptions

Pengaturan opsional untuk komposisi arkib.

`Examples`

Menulis data yang dikompresi ke HTTP respons stream.

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

`Remarks`

harus dapat ditulis.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Sumber tersebut tidak dibekali.

`Save(Keterangan, ZstandardSaveOptions)`

Simpan file ke file tujuan yang disediakan.

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

`Parameters`

destinationFileName string

Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.

settings ZstandardSaveOptions

Pengaturan opsional untuk komposisi arkib.

`Examples`

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

`Exceptions`

destinationFileName’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses.

destinationFileName’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah.

Akses ke file destinationFileName’ ditolak.

Destinasi destinationFileName’, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. misalnya, pada platform Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

File di destinationFileName’ mengandung kolom (:) di tengah string.

`Save(FileInfo dan ZstandardSaveOptions)`

Simpan file ke file tujuan yang disediakan.

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

`Parameters`

destination FileInfo

FileInfo, yang akan dibuka sebagai aliran tujuan.

settings ZstandardSaveOptions

Pengaturan opsional untuk komposisi arkib.

`Examples`

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

`Exceptions`

Panggilan tidak memiliki izin yang diperlukan untuk membuka destination'.

Jalur file kosong atau hanya mengandung ruang putih.

FileNotFoundException

File tersebut tidak ditemukan.

Jalan ke file hanya dibaca atau merupakan direktori.

DirectoryNotFoundException

destination’ is null.

Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.

IOException

File sudah terbuka.

`SetSource(Stream)`

Menetapkan konten untuk dikompresi di dalam arkib.

public void SetSource(Stream source)

`Parameters`

source Stream

Aliran input untuk arkib.

`Examples`

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

`SetSource(FileInfo)`

Menetapkan konten untuk dikompresi di dalam arkib.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Referensi ke file yang harus dikompresi.

`Examples`

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

`SetSource(String)`

Menetapkan konten untuk dikompresi di dalam arkib.

public void SetSource(string path)

`Parameters`

path string

Cara membuat file untuk dikompresi.

`Examples`

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

`Exceptions`

path’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses.

path’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah.

Akses ke file path’ ditolak.

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.