Class SharArchive
Nama dari : Aspose.Zip.Shar Perhitungan: Aspose.Zip.dll (25.5.0)
Kelas ini mewakili file arkib yang tajam.
public class SharArchive : IDisposableInheritance
Implements
anggota yang diwarisi
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Initifikasi instans baru dari kelas Aspose.Zip.Shar.SharArchive.
public SharArchive()Examples
Contoh berikut menunjukkan cara mengkompresi file.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(String)
Inicialisasi contoh baru dari kelas Aspose.Zip.Shar.SharArchive yang siap untuk dekompresi.
public SharArchive(string path)Parameters
path string
Jalan menuju sumber arsip.
Exceptions
path’ is null.
Panggilan tidak memiliki izin yang diperlukan untuk mengakses.
path’ kosong, hanya mengandung ruang putih, atau mengandung karakter yang tidak sah.
Akses ke file path’ ditolak.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
File di path’ mengandung kolom (:) di tengah string.
File tersebut tidak ditemukan.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File sudah terbuka.
Properties
Entries
Dapatkan entri dari Aspose.Zip.Shar.SharEntry jenis yang membentuk arkib.
public ReadOnlyCollection<sharentry> Entries { get; }Nilai Properti
ReadOnlyCollection dan lt; SharEntry >
Methods
CreateEntries(Kekuatan, Bool)
Menambah ke arkib semua file dan direktori secara berulang-ulang dalam direktori yang diberikan.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
direktori untuk kompresi.
includeRootDirectory bool
Menunjukkan apakah untuk memasukkan direktori akar itu sendiri atau tidak.
Returns
Instansi masuknya.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(sharFile);
}
}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(Informasi lengkap, bool)
Menambah ke arkib semua file dan direktori secara berulang-ulang dalam direktori yang diberikan.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
direktori untuk kompresi.
includeRootDirectory bool
Menunjukkan apakah untuk memasukkan direktori akar itu sendiri atau tidak.
Returns
Instansi masuknya.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(sharFile);
}
}Exceptions
directory’ is null.
Panggilan tidak memiliki izin yang diperlukan untuk mengakses directory'.
directory’ stands for a file, not for a directory.
CreateEntry(FileInfo, FileInfo dan Bool)
Mencipta satu entri dalam arkib.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)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.
Returns
Instansi masuknya.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}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 dan Bool)
Mencipta satu entri dalam arkib.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)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.
Returns
Instansi masuknya.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}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.
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 tajam.
File di sourcePath’ mengandung kolom (:) di tengah string.
CreateEntry(String dan Stream)
Mencipta satu entri dalam arkib.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Nama dari pintu masuk.
source Stream
Langkah masuk untuk masuk.
Returns
Instansi masuknya.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.shar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
DeleteEntry(SharEntry)
Menghapus penampilan pertama entri tertentu dari daftar entri.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
Kemasukan untuk dihapus dari daftar kemasukan.
Returns
Instansi masuknya.
Examples
Berikut cara menghapus semua entri kecuali yang terakhir:
using (var archive = new SharArchive("archive.shar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputSharFile);
}Exceptions
entry’ is null.
DeleteEntry(int)
Menghapus entri dari daftar entri dengan indeks.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Indeks berbasis nol dari entri yang harus dihapus.
Returns
Arsip dengan entri dihapus.
Examples
using (var archive = new SharArchive("two_files.shar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.shar");
}Exceptions
entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.
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.
Dispose()
Melaksanakan tugas-tugas yang ditentukan oleh aplikasi yang terkait dengan pembebasan, pembebasan, atau reset sumber daya yang tidak dikelola.
public void Dispose()Save(String)
Simpan file ke file tujuan yang disediakan.
public void Save(string destinationFileName)Parameters
destinationFileName string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Namun, ini tidak disarankan karena pendekatan ini menggunakan salinan ke file sementara.
Exceptions
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
Destinasi destinationFileName’, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. misalnya, pada platform Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
Destinasi destinasiFileName’ tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
Kesalahan I/O terjadi saat membuka file.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
File tersebut tidak ditemukan.
Save(Stream)
Simpan file ke arus yang disediakan.
public void Save(Stream output)Parameters
output Stream
Destinasi dari Stream.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
