Class ZstandardArchive

path adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

path kosong, hanya berisi spasi, atau mengandung karakter yang tidak valid.

Akses ke file path ditolak.

path, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, di platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

File di path mengandung titik dua (:) di tengah string.

Metode

Dispose()

Melakukan tugas yang ditentukan oleh aplikasi terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak dikelola.

public void Dispose()

Dispose(bool)

Melakukan tugas yang ditentukan oleh aplikasi terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak dikelola.

protected virtual void Dispose(bool disposing)

Parameter

disposing bool

Apakah sumber daya yang dikelola harus dibebaskan.

Extract(Stream)

Mengekstrak arsip ke stream yang disediakan.

public void Extract(Stream destination)

Parameter

destination Stream

Stream tujuan. Harus dapat ditulis.

Contoh

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

Pengecualian

destination tidak mendukung penulisan.

Extract(string)

Mengekstrak arsip ke file berdasarkan jalur.

public FileInfo Extract(string path)

Parameter

path string

Jalur ke file tujuan. Jika file sudah ada, file tersebut akan ditimpa.

Mengembalikan

FileInfo

Info file yang diekstrak.

Pengecualian

path adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

path kosong, hanya berisi spasi, atau mengandung karakter yang tidak valid.

Akses ke file path ditolak.

File di path mengandung titik dua (:) di tengah string.

ExtractToDirectory(string)

Mengekstrak konten arsip ke direktori yang disediakan.

public void ExtractToDirectory(string destinationDirectory)

Parameter

destinationDirectory string

Jalur ke direktori untuk menempatkan file yang diekstrak.

Keterangan

Jika direktori tidak ada, direktori tersebut akan dibuat.

Pengecualian

destinationDirectory adalah null.

path, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, di platform berbasis Windows, jalur harus kurang dari 248 karakter dan nama file harus kurang dari 260 karakter.

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

Jika direktori tidak ada, jalur mengandung karakter titik dua (:) yang bukan bagian dari label drive (“C:").

destinationDirectory adalah string dengan panjang nol, hanya berisi spasi, atau mengandung satu atau lebih karakter yang tidak valid. Anda dapat menanyakan karakter yang tidak valid dengan menggunakan metode System.IO.Path.GetInvalidPathChars. -atau- jalur diawali dengan, atau hanya mengandung, karakter titik dua (:).

IOException

Direktori yang ditentukan oleh jalur adalah sebuah file. -atau- Nama jaringan tidak dikenal.

Open()

Membuka arsip untuk ekstraksi dan menyediakan stream dengan konten arsip.

public Stream Open()

Mengembalikan

Stream

Stream yang merepresentasikan isi arsip.

Contoh

Mengekstrak arsip dan menyalin konten yang diekstrak ke stream file.

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.CopyTo(extracted);`

Keterangan

Baca dari stream untuk mendapatkan konten asli file. Lihat bagian contoh.

Save(Stream, ZstandardSaveOptions)

Menyimpan arsip ke stream yang disediakan.

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

Parameter

outputStream Stream

Stream tujuan.

settings ZstandardSaveOptions

Pengaturan opsional untuk komposisi arsip.

Contoh

Menulis data terkompresi ke stream respons http.

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

Keterangan

outputStream harus dapat ditulis.

Pengecualian

InvalidOperationException

outputStream tidak dapat ditulis.

Sumber belum disuplai.

Save(string, ZstandardSaveOptions)

Menyimpan arsip ke file tujuan yang disediakan.

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

Parameter

destinationFileName string

Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.

settings ZstandardSaveOptions

Pengaturan opsional untuk komposisi arsip.

Contoh

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

Pengecualian

destinationFileName adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

destinationFileName kosong, hanya berisi spasi, atau mengandung karakter yang tidak valid.

Akses ke file destinationFileName ditolak.

destinationFileName, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, di platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

File di destinationFileName mengandung titik dua (:) di tengah string.

Save(FileInfo, ZstandardSaveOptions)

Menyimpan arsip ke file tujuan yang disediakan.

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

Parameter

destination FileInfo

FileInfo yang akan dibuka sebagai stream tujuan.

settings ZstandardSaveOptions

Pengaturan opsional untuk komposisi arsip.

Contoh

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

Pengecualian

Pemanggil tidak memiliki izin yang diperlukan untuk membuka destination.

Jalur file kosong atau hanya berisi spasi.

FileNotFoundException

File tidak ditemukan.

Jalur ke file bersifat hanya-baca atau merupakan direktori.

DirectoryNotFoundException

destination adalah null.

Jalur yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.

IOException

File sudah terbuka.

SetSource(Stream)

Mengatur konten yang akan dikompresi dalam arsip.

public void SetSource(Stream source)

Parameter

source Stream

Stream input untuk arsip.

Contoh

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

SetSource(FileInfo)

Mengatur konten yang akan dikompresi dalam arsip.

public void SetSource(FileInfo fileInfo)

Parameter

fileInfo FileInfo

Referensi ke file yang akan dikompresi.

Contoh

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

SetSource(string)

Mengatur konten yang akan dikompresi dalam arsip.

public void SetSource(string path)

Parameter

path string

Jalur ke file yang akan dikompresi.

Contoh

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

Pengecualian

path adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

path kosong, hanya berisi spasi, atau mengandung karakter yang tidak valid.

Akses ke file path ditolak.