Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Mewakili arsip ISO (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposable
Pewarisan
Mengimplementasikan
Anggota yang Dwarisi
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktor
IsoArchive()
Menginisialisasi instansi baru dari kelas Aspose.Zip.Iso.IsoArchive dan membuat arsip ISO kosong untuk menambahkan file dan direktori baru.
public IsoArchive()
Contoh
Contoh berikut menunjukkan cara membuat arsip ISO kosong baru dan menambahkan file ke dalamnya:
// Buat arsip ISO kosong baru
using(IsoArchive isoArchive = new IsoArchive())
{
// Tambahkan file ke arsip ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Simpan arsip ISO ke file
isoArchive.Save("new_archive.iso");
}
IsoArchive(Stream, IsoLoadOptions)
Menginisialisasi instansi baru dari kelas Aspose.Zip.Iso.IsoArchive dan menyusun daftar entri yang dapat diekstrak dari arsip.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)
Parameter
sourceStream
Stream
Sumber arsip. Harus dapat dicari.
loadOptions
IsoLoadOptions
Opsi untuk memuat arsip.
Contoh
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
Keterangan
Konstruktor ini tidak membongkar entri apa pun.
Pengecualian
sourceStream
adalah null.
sourceStream
tidak dapat dicari.
sourceStream
bukan arsip ISO yang valid.
IsoArchive(string, IsoLoadOptions)
Menginisialisasi instansi baru dari kelas Aspose.Zip.Iso.IsoArchive dan menyusun daftar entri yang dapat diekstrak dari arsip.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)
Parameter
path
string
Jalur ke file arsip.
loadOptions
IsoLoadOptions
Opsi untuk memuat arsip.
Contoh
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}
Keterangan
Konstruktor ini tidak membongkar entri apa pun.
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, di platform berbasis Windows, jalur 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.
Jalur yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.
File sudah terbuka.
File terlalu pendek.
Properti
Entries
Mendapatkan entri dari tipe Aspose.Zip.Iso.IsoEntry yang membentuk arsip.
public ReadOnlyCollection<isoentry> Entries { get; }
Nilai Properti
ReadOnlyCollection<IsoEntry>
Metode
CreateDirectory(string)
Menambahkan direktori ke gambar ISO.
public IsoEntry CreateDirectory(string name)
Parameter
name
string
Jalur direktori di ISO.
Mengembalikan
Entri ISO yang disusun.
Pengecualian
Arsip dibuka untuk ekstraksi.
name
adalah null atau kosong.
CreateEntry(string, string)
Menambahkan file ke gambar ISO.
public IsoEntry CreateEntry(string name, string filePath)
Parameter
name
string
Jalur file di ISO.
filePath
string
Jalur file.
Mengembalikan
Entri ISO yang disusun.
Pengecualian
filePath
adalah null.
filePath
kosong, hanya berisi spasi putih, atau mengandung karakter yang tidak valid.
Akses ke file filePath
ditolak.
filePath
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 filePath
mengandung tanda titik dua (:) di tengah string.
Terjadi kesalahan I/O saat membuka file.
CreateEntry(string, Stream)
Menambahkan file ke gambar ISO.
public IsoEntry CreateEntry(string name, Stream source)
Parameter
name
string
Jalur file di ISO.
source
Stream
Stream yang berisi data file.
Mengembalikan
Entri ISO yang disusun.
CreateEntry(string)
Menambahkan file ke gambar ISO.
public IsoEntry CreateEntry(string name)
Parameter
name
string
Jalur direktori di ISO.
Mengembalikan
Entri ISO yang disusun.
Pengecualian
name
adalah null atau kosong.
Arsip dibuka untuk ekstraksi.
Dispose()
Melakukan tugas yang ditentukan aplikasi terkait dengan membebaskan, melepaskan, atau mengatur ulang sumber daya yang tidak dikelola.
public void Dispose()
ExtractToDirectory(string)
Mengekstrak semua entri ke direktori yang ditentukan.
public void ExtractToDirectory(string destinationDirectory)
Parameter
destinationDirectory
string
Direktori untuk mengekstrak entri.
Contoh
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
Pengecualian
Dilemparkan ketika arsip dalam mode pengeditan.
Dilemparkan ketika destinationDirectory
adalah null.
Save(string, IsoSaveOptions)
Menyimpan gambar ISO ke jalur yang ditentukan.
public void Save(string path, IsoSaveOptions saveOptions = null)
Parameter
path
string
Jalur tempat gambar ISO akan disimpan.
saveOptions
IsoSaveOptions
Opsi untuk menyimpan arsip ISO.
Contoh
Contoh berikut menunjukkan cara menyimpan arsip ISO ke file:
// Buat arsip ISO kosong baru
using(IsoArchive isoArchive = new IsoArchive())
{
// Tambahkan file ke arsip ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Simpan arsip ISO ke file
isoArchive.Save("new_archive.iso");
}
Pengecualian
Dilemparkan ketika arsip tidak dalam mode pengeditan.
Dilemparkan ketika path
adalah null.
Dilemparkan ketika jalur yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.
Dilemparkan ketika file sudah terbuka.
Dilemparkan ketika akses ke file path
ditolak.
Dilemparkan ketika path
yang ditentukan melebihi panjang maksimum yang ditentukan oleh sistem.
Save(Stream, IsoSaveOptions)
Menyimpan gambar ISO ke stream yang ditentukan.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)
Parameter
stream
Stream
Stream tempat gambar ISO akan disimpan.
saveOptions
IsoSaveOptions
Opsi untuk menyimpan arsip ISO.
Contoh
Contoh berikut menunjukkan cara menyimpan arsip ISO ke stream memori:
// Buat arsip ISO kosong baru
using(IsoArchive isoArchive = new IsoArchive())
{
// Tambahkan file ke arsip ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Simpan arsip ISO ke stream memori
isoArchive.Save(memoryStream);
}
Pengecualian
Dilemparkan ketika arsip tidak dalam mode pengeditan.
Dilemparkan ketika stream
adalah null.
Dilemparkan ketika stream
tidak dapat ditulis.