Class SnappyArchive

Class SnappyArchive

Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)

Kelas ini merepresentasikan file arsip snappy. Gunakan untuk menyusun atau mengekstrak arsip snappy.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

Warisan

objectSnappyArchive

Mengimplementasikan

IArchive, IDisposable, IArchiveFileEntry

Anggota yang Dwarisi

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Konstruktor

SnappyArchive()

Menginisialisasi instance baru dari kelas Aspose.Zip.Snappy.SnappyArchive yang disiapkan untuk kompresi.

public SnappyArchive()

Contoh

Contoh berikut menunjukkan cara mengompres file.

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snapy");
}

SnappyArchive(Stream)

Menginisialisasi instance baru dari kelas Aspose.Zip.Snappy.SnappyArchive yang disiapkan untuk dekompresi.

public SnappyArchive(Stream source)

Parameter

source Stream

Sumber arsip.

Catatan

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

Pengecualian

ArgumentException

source tidak dapat dicari.

ArgumentNullException

source adalah null.

SnappyArchive(string)

Menginisialisasi instance baru dari kelas Aspose.Zip.Snappy.SnappyArchive yang disiapkan untuk dekompresi.

public SnappyArchive(string path)

Parameter

path string

Path ke sumber arsip.

Contoh

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

Catatan

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

Pengecualian

ArgumentNullException

path adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

ArgumentException

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

UnauthorizedAccessException

Akses ke file path ditolak.

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

File tidak ditemukan.

DirectoryNotFoundException

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

IOException

File sudah terbuka.

Metode

Dispose()

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

public void Dispose()

Dispose(bool)

Melakukan tugas yang ditentukan oleh aplikasi yang 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 snappy ke stream.

public void Extract(Stream destination)

Parameter

destination Stream

Stream untuk menyimpan data yang didekompresi.

Contoh

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

Pengecualian

InvalidOperationException

Header arsip dan informasi layanan tidak dibaca.

InvalidDataException

Kesalahan dalam data di header atau checksum.

ArgumentNullException

Stream tujuan adalah null.

ArgumentException

Stream tujuan tidak mendukung penulisan.

Extract(FileInfo)

Mengekstrak arsip snappy ke file.

public void Extract(FileInfo fileInfo)

Parameter

fileInfo FileInfo

FileInfo untuk menyimpan data yang didekompresi.

Contoh

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

Pengecualian

InvalidOperationException

Header arsip dan informasi layanan tidak dibaca.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk membuka fileInfo.

ArgumentException

Path file kosong atau hanya berisi spasi putih.

FileNotFoundException

File tidak ditemukan.

UnauthorizedAccessException

Path ke file bersifat read-only atau merupakan direktori.

ArgumentNullException

fileInfo adalah null.

DirectoryNotFoundException

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

IOException

File sudah terbuka.

Extract(string)

Mengekstrak arsip snappy ke file berdasarkan path.

public FileInfo Extract(string path)

Parameter

path string

Path ke file yang akan menyimpan data yang didekompresi.

Mengembalikan

FileInfo

Instansi System.IO.FileInfo yang berisi data yang diekstrak.

Contoh

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

Pengecualian

InvalidOperationException

Header arsip dan informasi layanan tidak dibaca.

ArgumentNullException

path adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

ArgumentException

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

UnauthorizedAccessException

Akses ke file path ditolak.

PathTooLongException

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

NotSupportedException

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

ExtractToDirectory(string)

Mengekstrak konten arsip ke direktori yang diberikan.

public void ExtractToDirectory(string destinationDirectory)

Parameter

destinationDirectory string

Path ke direktori untuk menempatkan file yang diekstrak.

Catatan

Jika direktori tidak ada, direktori tersebut akan dibuat.

Pengecualian

ArgumentNullException

destinationDirectory adalah null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

Save(Stream)

Menyimpan arsip snappy ke stream yang diberikan.

public void Save(Stream output)

Parameter

output Stream

Stream tujuan.

Contoh

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

Catatan

output harus dapat dicari.

Pengecualian

ArgumentException

output tidak mendukung pencarian.

ArgumentNullException

output adalah null.

Save(FileInfo)

Menyimpan arsip snappy ke file tujuan yang diberikan.

public void Save(FileInfo destination)

Parameter

destination FileInfo

FileInfo yang akan dibuka sebagai stream tujuan.

Contoh

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

Pengecualian

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk membuka destination.

ArgumentException

Path file kosong atau hanya berisi spasi putih.

FileNotFoundException

File tidak ditemukan.

UnauthorizedAccessException

Path ke file bersifat read-only atau merupakan direktori.

ArgumentNullException

destination adalah null.

DirectoryNotFoundException

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

IOException

File sudah terbuka.

Save(string)

Menyimpan arsip snappy ke file tujuan yang diberikan.

public void Save(string destinationFileName)

Parameter

destinationFileName string

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

Contoh

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

Pengecualian

ArgumentNullException

destinationFileName adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

ArgumentException

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

UnauthorizedAccessException

Akses ke file destinationFileName ditolak.

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

Menetapkan konten yang akan dikompresi dalam arsip.

public void SetSource(Stream source)

Parameter

source Stream

Stream input untuk arsip.

Contoh

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

Pengecualian

ArgumentException

Stream source tidak dapat dicari.

SetSource(FileInfo)

Menetapkan 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 SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.snappy");
}

Pengecualian

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk membuka fileInfo.

ArgumentException

Path file kosong atau hanya berisi spasi putih.

FileNotFoundException

File tidak ditemukan.

UnauthorizedAccessException

Path ke file bersifat read-only atau merupakan direktori.

ArgumentNullException

fileInfo adalah null.

DirectoryNotFoundException

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

IOException

File sudah terbuka.

SetSource(string)

Menetapkan 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 SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

Pengecualian

ArgumentNullException

sourcePath adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

ArgumentException

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

UnauthorizedAccessException

Akses ke file sourcePath ditolak.

PathTooLongException

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

NotSupportedException

File di sourcePath mengandung tanda titik dua (:) di tengah string.

 Indonesia