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
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
source
tidak dapat dicari.
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
path
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.
path
kosong, hanya berisi spasi putih, atau mengandung karakter yang tidak valid.
Akses ke file path
ditolak.
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.
File di path
mengandung tanda titik dua (:) di tengah string.
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 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
Header arsip dan informasi layanan tidak dibaca.
Kesalahan dalam data di header atau checksum.
Stream tujuan adalah null.
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
Header arsip dan informasi layanan tidak dibaca.
Pemanggil tidak memiliki izin yang diperlukan untuk membuka fileInfo
.
Path file kosong atau hanya berisi spasi putih.
File tidak ditemukan.
Path ke file bersifat read-only atau merupakan direktori.
fileInfo
adalah null.
Path yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.
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
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
Header arsip dan informasi layanan tidak dibaca.
path
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.
path
kosong, hanya berisi spasi putih, atau mengandung karakter yang tidak valid.
Akses ke file path
ditolak.
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.
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
destinationDirectory
adalah null.
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.
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 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 (:).
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
output
tidak mendukung pencarian.
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
Pemanggil tidak memiliki izin yang diperlukan untuk membuka destination
.
Path file kosong atau hanya berisi spasi putih.
File tidak ditemukan.
Path ke file bersifat read-only atau merupakan direktori.
destination
adalah null.
Path yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.
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
destinationFileName
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.
destinationFileName
kosong, hanya berisi spasi putih, atau mengandung karakter yang tidak valid.
Akses ke file destinationFileName
ditolak.
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.
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
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
Pemanggil tidak memiliki izin yang diperlukan untuk membuka fileInfo
.
Path file kosong atau hanya berisi spasi putih.
File tidak ditemukan.
Path ke file bersifat read-only atau merupakan direktori.
fileInfo
adalah null.
Path yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.
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
sourcePath
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.
sourcePath
kosong, hanya berisi spasi putih, atau mengandung karakter yang tidak valid.
Akses ke file sourcePath
ditolak.
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.
File di sourcePath
mengandung tanda titik dua (:) di tengah string.