Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Ketiga, XarLoadOptions)`

Inicialisasi instansi baru dari kelas Aspose.Zip.Xar.xarArchive dan menyusun daftar entri yang dapat dikeluarkan dari arkib.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Jalan menuju file arkib.

loadOptions XarLoadOptions

Pilihan untuk mengisi file dengan.

`Examples`

Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Konstruktor ini tidak membungkus entri apa pun. lihat Aspose.Zip.Xar.XarFileEntry.Open metode untuk membungkus.

`Exceptions`

path’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses.

UnauthorizedAccessException

path’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah.

Akses ke file path’ ditolak.

DirectoryNotFoundException

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

NotSupportedException

File di path’ mengandung kolom (:) di tengah string.

FileNotFoundException

File tersebut tidak ditemukan.

Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.

File sudah terbuka.

InvalidDataException

File di path’ tidak sah arsip xar.

`Properties`

`Entries`

Dapatkan entri dari Aspose.Zip.Xar.XarEntry jenis yang membentuk arkib.

public IEnumerable<xarentry> Entries { get; }

`Nilai Properti`

IEnumerable dan lt; XarEntry >

`Methods`

`CreateEntries(String, Bool, dan XarCompressionSettings)`

Menambah ke arkib semua file dan direktori secara berulang-ulang dalam direktori yang diberikan.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

direktori untuk kompresi.

includeRootDirectory bool

Menunjukkan apakah untuk memasukkan direktori akar itu sendiri atau tidak.

compressionSettings XarCompressionSettings

Tetapan kompresi yang digunakan untuk menambahkan Aspose.Zip.Xar.XarEntry item.

`Returns`

XarArchive

Instansi yang masuk.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(Info, Bool, XarCompressionSettings)`

Menambah ke arkib semua file dan direktori secara berulang-ulang dalam direktori yang diberikan.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

direktori untuk kompresi.

includeRootDirectory bool

Menunjukkan apakah untuk memasukkan direktori akar itu sendiri atau tidak.

compressionSettings XarCompressionSettings

Tetapan kompresi yang digunakan untuk menambahkan Aspose.Zip.Xar.XarEntry item.

`Returns`

XarArchive

Instansi yang masuk.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

`Exceptions`

directory’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses directory'.

directory’ stands for a file, not for a directory.

`CreateEntry(string, FileInfo, bool, XarCompressionSettings)`

Mencipta satu entri dalam arkib.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Nama dari pintu masuk.

fileInfo FileInfo

Metadata file atau folder untuk dikompresi.

openImmediately bool

Memang benar, jika Anda membuka file dengan serta-merta, jika tidak, buka file pada penyimpanan.

compressionSettings XarCompressionSettings

Tetapan kompresi yang digunakan untuk menambahkan Aspose.Zip.Xar.XarEntry item.

`Returns`

XarEntry

Instansi yang masuk.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

`Remarks`

Jika file dibuka dengan segera dengan parameter itu diblokir sampai arsip dihapus.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string, string, bool, XarCompressionSettings)`

Mencipta satu entri dalam arkib.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Nama dari pintu masuk.

sourcePath string

Cara membuat file untuk dikompresi.

openImmediately bool

Memang benar, jika Anda membuka file dengan serta-merta, jika tidak, buka file pada penyimpanan.

compressionSettings XarCompressionSettings

Tetapan kompresi yang digunakan untuk menambahkan Aspose.Zip.Xar.XarEntry item.

`Returns`

XarEntry

Instansi yang masuk.

`Examples`

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

`Remarks`

Nama input hanya ditetapkan dalam parameter. nama file yang disediakan dalam parameter tidak mempengaruhi nama input.

Jika file dibuka dengan segera dengan parameter itu diblokir sampai arsip dihapus.

`Exceptions`

sourcePath’ is null.

Panggilan tidak memiliki izin yang diperlukan untuk mengakses.

UnauthorizedAccessException

sourcePath’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah. - atau - Nama file, sebagai bagian dari name’, melebihi 100 simbol.

Akses ke file sourcePath’ ditolak.

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter. - atau - name’ terlalu panjang untuk xar.

NotSupportedException

File di sourcePath’ mengandung kolom (:) di tengah string.

Tidak mungkin untuk mengubah arsip.

`CreateEntry(String, Stream dan XarCompressionSettings)`

Mencipta satu entri dalam arkib.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Nama dari pintu masuk.

source Stream

Langkah masuk untuk masuk.

compressionSettings XarCompressionSettings

Tetapan kompresi yang digunakan untuk menambahkan Aspose.Zip.Xar.XarEntry item.

`Returns`

XarEntry

Instansi yang masuk.

`Examples`

using (var archive = new XarArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.xar");
}

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

Tidak mungkin untuk mengubah arsip.

`DeleteEntry(XarEntry)`

Menghapus penampilan pertama entri tertentu dari daftar entri.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Kemasukan untuk dihapus dari daftar kemasukan.

`Returns`

XarArchive

Instansi yang masuk.

`Examples`

Berikut cara menghapus semua entri kecuali yang terakhir:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

`Dispose()`

Melaksanakan tugas-tugas yang ditentukan oleh aplikasi yang terkait dengan pembebasan, pembebasan, atau reset sumber daya yang tidak dikelola.

public void Dispose()

`Dispose(Bool)`

Melaksanakan tugas-tugas yang ditentukan oleh aplikasi yang terkait dengan pembebasan, pembebasan, atau reset sumber daya yang tidak dikelola.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Apakah sumber daya yang dikelola harus dihapus.

`ExtractToDirectory(String)`

Mengekstrak semua file dalam arkib ke direktori yang disediakan.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Jalan menuju direktori untuk menempatkan file yang dikeluarkan.

`Examples`

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Jika direktori tidak ada, itu akan dibuat.

`Exceptions`

Jalan adalah null

Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter dan nama file harus kurang dari 260 karakter.

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

NotSupportedException

Jika direktori tidak ada, jalur ini mengandung karakter kolon (:) yang bukan bagian dari label drive (“C:”).

jalur adalah jalur panjang sifar, hanya mengandung ruang putih, atau mengandung satu atau lebih karakter yang tidak sah. Anda dapat meminta karakter yang tidak sah dengan menggunakan metode System.IO.Path.GetInvalidPathChars. -or- jalur ditetapkan dengan, atau mengandung, hanya karakter kolon (:).

Direktori yang ditentukan oleh jalur adalah file. -or- Nama jaringan tidak diketahui.

InvalidDataException

Arsip ini sudah rusak.

`Save(Keterangan, XarSaveOptions)`

Simpan file ke file tujuan yang disediakan.

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

`Parameters`

destinationFileName string

Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.

saveOptions XarSaveOptions

Pilihan untuk menyimpan arsip xar dengan.

`Exceptions`

destinationFileName’ is null.

Tidak mungkin untuk mengubah arsip.

`Save(Perbedaan, XarSaveOptions)`

Simpan file ke arus yang disediakan.

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

Destinasi dari Stream.

saveOptions XarSaveOptions

Pilihan untuk menyimpan arsip xar dengan.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.