Class ZArchive

source tidak dapat dicari.

source adalah null.

ZArchive(string, ZArchiveLoadOptions)

Menginisialisasi instance baru dari kelas Aspose.Zip.Z.ZArchive yang disiapkan untuk dekompresi.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameter

path string

Path ke sumber arsip.

loadOptions ZArchiveLoadOptions

Opsi untuk memuat arsip.

Catatan

Konstruktor ini tidak melakukan dekompresi. Lihat metode Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) untuk dekompresi.

Pengecualian

path adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

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

Akses ke file path ditolak.

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

DirectoryNotFoundException

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

FileNotFoundException

File tidak ditemukan.

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

File sudah terbuka.

Metode

Dispose()

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

public void Dispose()

Dispose(bool)

Melakukan tugas yang ditentukan oleh aplikasi terkait dengan membebaskan, melepaskan, atau mengatur ulang 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 Z ke dalam stream.

public void Extract(Stream destination)

Parameter

destination Stream

Stream untuk menyimpan data yang didekompresi.

Contoh

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);
        }
    }
}

Pengecualian

InvalidDataException

Data tidak dapat didekompresi.

Extract(FileInfo)

Mengekstrak arsip Z ke dalam file.

public void Extract(FileInfo fileInfo)

Parameter

fileInfo FileInfo

FileInfo untuk menyimpan data yang didekompresi.

Contoh

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

Pengecualian

Pemanggil tidak memiliki izin yang diperlukan untuk membuka fileInfo.

Path file kosong atau hanya berisi spasi putih.

FileNotFoundException

File tidak ditemukan.

Path ke file bersifat hanya-baca atau merupakan direktori.

DirectoryNotFoundException

fileInfo adalah null.

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

File sudah terbuka.

InvalidDataException

Data tidak dapat didekompresi.

Extract(string)

Mengekstrak arsip Z ke dalam file berdasarkan path.

public FileInfo Extract(string path)

Parameter

path string

Path ke file yang akan menyimpan data yang didekompresi.

Mengembalikan

FileInfo

Info file yang diekstrak.

Contoh

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

Pengecualian

path adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

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

Akses ke file path ditolak.

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

InvalidDataException

Data tidak dapat didekompresi.

ExtractToDirectory(string)

Mengekstrak konten arsip ke direktori yang disediakan.

public void ExtractToDirectory(string destinationDirectory)

Parameter

destinationDirectory string

Path ke direktori untuk menempatkan file yang diekstrak.

Catatan

Jika direktori tidak ada, itu akan dibuat.

Pengecualian

destinationDirectory adalah null.

Path yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, di platform berbasis Windows, path 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, path mengandung karakter titik dua (:) yang bukan bagian dari label drive (“C:").

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

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

Save(Stream, ZArchiveSaveOptions)

Menyimpan arsip xz ke stream yang disediakan.

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

Parameter

output Stream

Stream tujuan.

settings ZArchiveSaveOptions

Pengaturan opsional untuk komposisi arsip.

Contoh

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

Catatan

output harus dapat dicari.

Pengecualian

output tidak mendukung pencarian.

output adalah null.

Save(string, ZArchiveSaveOptions)

Menyimpan arsip Z ke file tujuan yang disediakan.

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

Parameter

destinationFileName string

+Path arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang ada, file tersebut akan ditimpa.

settings ZArchiveSaveOptions

Pengaturan opsional untuk komposisi arsip.

Contoh

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

Pengecualian

destinationFileName adalah null.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

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

Akses ke file destinationFileName ditolak.

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

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

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 ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

Mengatur konten yang akan dikompresi dalam arsip.

public void SetSource(FileInfo fileInfo)

Parameter

fileInfo FileInfo

FileInfo yang akan dibuka sebagai stream input.

Contoh

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

Pengecualian

Pemanggil tidak memiliki izin yang diperlukan untuk membuka fileInfo.

Path file kosong atau hanya berisi spasi putih.

FileNotFoundException

File tidak ditemukan.

Path ke file bersifat hanya-baca atau merupakan direktori.

DirectoryNotFoundException

fileInfo adalah null.

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

File sudah terbuka.

SetSource(string)

Mengatur konten yang akan dikompresi dalam arsip.

public void SetSource(string sourcePath)

Parameter

sourcePath string

Path ke file yang akan dibuka sebagai stream input.

Contoh

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

Pengecualian

sourcePath adalah null atau string kosong.

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses sumber daya.

sourcePath kosong, hanya berisi spasi putih, atau mengandung karakter tidak valid.

Akses ke file sourcePath ditolak.

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