Class TarArchive
Nama dari : Aspose.Zip.Tar Perhitungan: Aspose.Zip.dll (25.5.0)
Kelas ini mewakili file arsip tar. Gunakan untuk menyusun, mengekstrak, atau memperbarui arkib Tar.
public class TarArchive : IArchive, IDisposable
Inheritance
Implements
anggota yang diwarisi
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
TarArchive()
Initifikasi instans baru dari kelas Aspose.Zip.Tar.TarArchive.
public TarArchive()
Examples
Contoh berikut menunjukkan cara mengkompresi file.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
Inicialisasi contoh baru dari kelas Aspose.Zip.Archive dan menyusun daftar entri yang dapat dikeluarkan dari arkib.
public TarArchive(Stream sourceStream)
Parameters
sourceStream
Stream
Sumber dari arkib. harus dapat dicari.
Examples
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Konstruktor ini tidak membungkus entri apa pun. lihat Aspose.Zip.Tar.TarEntry.Metode terbuka untuk membungkus.
Exceptions
sourceStream’ is not seekable.
sourceStream’ is null.
TarArchive(String)
Inicialisasi instansi baru dari kelas Aspose.Zip.Tar.tarArchive dan menyusun daftar entri yang dapat dikeluarkan dari arkib.
public TarArchive(string path)
Parameters
path
string
Jalan menuju file arkib.
Examples
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Konstruktor ini tidak membungkus entri apa pun. lihat Aspose.Zip.Tar.TarEntry.Metode terbuka untuk membungkus.
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.Tar.TarEntry jenis yang membentuk arkib.
public ReadOnlyCollection<tarentry> Entries { get; }
Nilai Properti
ReadOnlyCollection dan lt; TarEntry >
Methods
CreateEntries(Informasi lengkap, bool)
Menambah ke arkib semua file dan direktori secara berulang-ulang dalam direktori yang diberikan.
public TarArchive 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
Arsip dengan entri yang disusun.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(tarFile);
}
}
CreateEntries(Kekuatan, Bool)
Menambah ke arkib semua file dan direktori secara berulang-ulang dalam direktori yang diberikan.
public TarArchive 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
Arsip dengan entri yang disusun.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(tarFile);
}
}
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.
CreateEntry(String, Stream dan FileSystemInfo)
Mencipta satu entri dalam arkib.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
Parameters
name
string
Nama dari pintu masuk.
source
Stream
Langkah masuk untuk masuk.
fileInfo
FileSystemInfo
Metadata file atau folder untuk dikompresi.
Returns
dengan instansi masuk.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
Remarks
Nama input hanya ditetapkan dalam parameter. nama file yang disediakan dalam parameter tidak mempengaruhi nama input.
dapat merujuk ke System.IO.DirectoryInfo jika entri adalah direktori.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Nama file, sebagai bagian dari name’, melebihi 100 simbol.
CreateEntry(FileInfo, FileInfo dan Bool)
Mencipta satu entri dalam arkib.
public TarEntry 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
dengan instansi masuk.
Examples
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
Remarks
Nama input hanya ditetapkan dalam parameter. nama file yang disediakan dalam parameter tidak mempengaruhi nama input.
dapat merujuk ke System.IO.DirectoryInfo jika entri adalah direktori.
Jika file dibuka dengan segera dengan parameter itu diblokir sampai arsip dihapus.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Nama file, sebagai bagian dari name’, melebihi 100 simbol.
CreateEntry(String, String dan Bool)
Mencipta satu entri dalam arkib.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
Parameters
name
string
Nama dari pintu masuk.
path
string
Cara membuat file untuk dikompresi.
openImmediately
bool
Memang benar, jika Anda membuka file dengan serta-merta, jika tidak, buka file pada penyimpanan.
Returns
dengan instansi masuk.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
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
path’ is null.
Panggilan tidak memiliki izin yang diperlukan untuk mengakses.
The path’ is empty, contains only white spaces, or contains invalid characters. - atau - Nama file, sebagai bagian dari
name’, melebihi 100 simbol.
Akses ke file path’ 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 tar dibandingkan dengan standar IEEE 1003.1-1998.
File di path’ mengandung kolom (:) di tengah string.
DeleteEntry(TarEntry)
Menghapus penampilan pertama entri tertentu dari daftar entri.
public TarArchive DeleteEntry(TarEntry entry)
Parameters
entry
TarEntry
Kemasukan untuk dihapus dari daftar kemasukan.
Returns
Arsip dengan entri dihapus.
Examples
Berikut cara menghapus semua entri kecuali yang terakhir:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(int)
Menghapus entri dari daftar entri dengan indeks.
public TarArchive DeleteEntry(int entryIndex)
Parameters
entryIndex
int
Indeks berbasis nol dari entri yang harus dihapus.
Returns
Arsip dengan entri dihapus.
Examples
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Exceptions
entryIndex’ is less than 0.-or-
entryIndex’ is equal to or greater than ‘Entries’ count.
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 TarArchive("archive.tar"))
{
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.
Jika direktori tidak ada, jalur ini mengandung karakter kolon (:) yang bukan bagian dari label drive (“C:”).
Path adalah string panjang sifar, hanya mengandung ruang putih, atau mengandung satu atau lebih karakter yang tidak sah. Anda dapat menanyakan karakter-karakter yang belum sah dengan menggunakan metode System.IO.Path.GetInvalidMathChars. - atau - jalur ini ditetapkan dengan atau berisi hanya karakter kolon (:).
Direktori yang ditentukan oleh jalur adalah file. - atau - Nama jaringan tidak diketahui.
dari GZIP(Stream)
Ekstrak yang disampaikan gzip archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: file gzip sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromGZip(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi GZip tidak dapat dicari oleh sifat algoritma kompresi.Arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan arus yang dapat dicari di bawah lubang.
Exceptions
Arsip ini sudah rusak.
dari GZIP(String)
Ekstrak yang disampaikan gzip archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: file gzip sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromGZip(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi GZip tidak dapat dicari oleh sifat algoritma kompresi.Arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan arus yang dapat dicari di bawah lubang.
Exceptions
path’ is null.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
Arsip ini sudah rusak.
dari LZ4(String)
Ekstrak yang disediakan LZ4 archive dan komposisi Aspose.Zip.Tar.tarArchive dari data yang dikeluarkan.
Penting: Arkib LZ4 sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromLZ4(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi LZ4 tidak dapat dicari oleh sifat algoritma kompresi. arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus beroperasi aliran yang dapat dikejar di bawah lubang.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
File ini terlalu pendek.
File ini memiliki tanda tangan yang salah.
dari LZ4(Stream)
Ekstrak yang disediakan LZ4 archive dan komposisi Aspose.Zip.Tar.tarArchive dari data yang dikeluarkan.
Penting: Arkib LZ4 sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromLZ4(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi LZ4 tidak dapat dicari oleh sifat algoritma kompresi. arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus beroperasi aliran yang dapat dikejar di bawah lubang.
Exceptions
Tidak dapat dibaca dari source’
source’ is null.
source’ is too short.
Sumber ” memiliki tanda tangan yang salah.
dari LZMA(Stream)
Ekstrak yang disediakan oleh LZMA archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: Arkib LZMA sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromLZMA(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi LZMA tidak dapat dicari oleh sifat algoritma kompresi. arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan aliran yang dapat dicari di bawah lubang.
Exceptions
Arsip ini sudah rusak.
dari LZMA(String)
Ekstrak yang disediakan oleh LZMA archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: Arkib LZMA sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromLZMA(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi LZMA tidak dapat dicari oleh sifat algoritma kompresi. arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus beroperasi aliran yang dapat dikejar di bawah lubang.
Exceptions
path’ is null.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
dari LZIP(Stream)
Ekstrak yang disediakan lzip archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: arkib lzip sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromLZip(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi Lzip tidak dapat dicari oleh sifat algoritma kompresi. arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan aliran yang dapat dicari di bawah lubang.
Exceptions
Arsip ini sudah rusak.
source’ is not seekable.
source’ is null.
dari LZIP(String)
Ekstrak yang disediakan lzip archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: arkib lzip sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromLZip(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Aliran ekstraksi Lzip tidak dapat dicari oleh sifat algoritma kompresi. arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan aliran yang dapat dicari di bawah lubang.
Exceptions
path’ is null.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
Arsip ini sudah rusak.
FromXz(Stream)
Ekstrak yang disediakan dalam format xz dan komposisi Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: file xz dikeluarkan sepenuhnya dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromXz(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan arus yang dapat dicari di bawah lubang.
FromXz(String)
Ekstrak yang disediakan dalam format xz dan komposisi Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: file xz dikeluarkan sepenuhnya dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromXz(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan arus yang dapat dicari di bawah lubang.
Exceptions
path’ is null.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
dari Z(Stream)
Ekstrak yang disediakan dalam format Z dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: Arkib Z sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromZ(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan arus yang dapat dicari di bawah lubang.
dari Z(String)
Ekstrak yang disediakan dalam format Z dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: Arkib Z sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromZ(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Remarks
Arsip Tar menyediakan kemudahan untuk mengekstrak rekaman arbitrari, sehingga harus mengoperasikan arus yang dapat dicari di bawah lubang.
Exceptions
path’ is null.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
FromZstandard(Stream)
Ekstrak yang disampaikan Zstandard archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: Arkib Zstandard sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromZstandard(Stream source)
Parameters
source
Stream
sumber dari arkib tersebut.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Exceptions
Aliran Zstandard korup atau tidak dapat dibaca.
Data yang korup.
FromZstandard(String)
Ekstrak yang disampaikan Zstandard archive dan menyusun Aspose.Zip.Tar.TarArchive dari data yang dikeluarkan.
Penting: Arkib Zstandard sepenuhnya dikeluarkan dalam metode ini, kontennya disimpan secara internal.
public static TarArchive FromZstandard(string path)
Parameters
path
string
Jalan menuju file arkib.
Returns
Sebuah contoh dari Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
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’ adalah dalam format yang tidak sah.
Jalur yang ditentukan tidak sah, misalnya berada di drive yang tidak dipetakan.
File tersebut tidak ditemukan.
Aliran Zstandard korup atau tidak dapat dibaca.
Data yang korup.
Save(Perkembangan dan Tarformat?)
Simpan file ke arus yang disediakan.
public void Save(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
Remarks
harus dapat ditulis.
Exceptions
output’ is not writable. - or -
output’ is the same stream we extract from.- OR -It is impossible to save archive in
format’ due to format restrictions.
Save(Tertarik atau Tertarik?)
Simpan file ke file tujuan yang disediakan.
public void Save(string destinationFileName, TarFormat? format = null)
Parameters
destinationFileName
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
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.
SaveGzipped(Perkembangan dan Tarformat?)
Menyimpan arsip ke arus dengan kompresi gzip.
public void SaveGzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream result = File.OpenWrite("result.tar.gz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped(result);
}
}
}
Remarks
harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable.
SaveGzipped(Tertarik atau Tertarik?)
Simpan file ke file dengan kompresi gzip.
public void SaveGzipped(string path, TarFormat? format = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.gz");
}
}
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.
SaveLZ4 dikompresi(Perkembangan dan Tarformat?)
Menyimpan arsip ke aliran dengan kompresi LZ4.
public void SaveLZ4Compressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream result = File.OpenWrite("result.tar.lz4"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZ4Compressed(result);
}
}
}
Remarks
harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable.
SaveLZ4 dikompresi(Tertarik atau Tertarik?)
Simpan file ke file dengan kompresi LZ4.
public void SaveLZ4Compressed(string path, TarFormat? format = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZ4Compressed("result.tar.lz4");
}
}
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.
Menyelamatkan Kompres(Perkembangan dan Tarformat?)
Menyimpan arsip ke aliran dengan kompresi LZMA.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZMACompressed(result);
}
}
}
Remarks
harus dapat ditulis.
Penting: arsip tar disusun kemudian dikompresi dalam metode ini, kontennya disimpan secara internal.
Exceptions
output’ is null.
output’ is not writable.
Menyelamatkan Kompres(Tertarik atau Tertarik?)
Simpan file ke file dengan lzma kompresi.
public void SaveLZMACompressed(string path, TarFormat? format = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZMACompressed("result.tar.lzma");
}
}
Remarks
Penting: arsip tar disusun kemudian dikompresi dalam metode ini, kontennya disimpan secara internal.
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.
SaveLzipped(Perkembangan dan Tarformat?)
Menyimpan arsip ke aliran dengan kompresi lzip.
public void SaveLzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream result = File.OpenWrite("result.tar.lz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLzipped(result);
}
}
}
Remarks
harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable.
SaveLzipped(Tertarik atau Tertarik?)
Simpan file ke file dengan lzip kompresi.
public void SaveLzipped(string path, TarFormat? format = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.lz");
}
}
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.
SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)
Menyimpan arsip ke aliran dengan kompresi xz.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
settings
XzArchiveSettings
Set pengaturan tertentu xz archive: ukuran kamus, ukuran blok, jenis cek.
Examples
using (FileStream result = File.OpenWrite("result.tar.xz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed(result);
}
}
}
Remarks
Aliran harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable.
SaveXzCompressed(String, TarFormat?, XzArchiveSettings)
Menyimpan arsip ke jalur dengan kompresi xz.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
settings
XzArchiveSettings
Set pengaturan tertentu xz archive: ukuran kamus, ukuran blok, jenis cek.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed("result.tar.xz");
}
}
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.
Penyimpanan dikompresi(Perkembangan dan Tarformat?)
Menyimpan arsip ke aliran dengan kompresi Z.
public void SaveZCompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream result = File.OpenWrite("result.tar.Z"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed(result);
}
}
}
Remarks
harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable.
Penyimpanan dikompresi(Tertarik atau Tertarik?)
Menyimpan arsip ke jalur dengan kompresi Z.
public void SaveZCompressed(string path, TarFormat? format = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed("result.tar.Z");
}
}
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.
SaveZstandard(Perkembangan dan Tarformat?)
Menyimpan arsip ke aliran dengan kompresi Zstandard.
public void SaveZstandard(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinasi dari Stream.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream result = File.OpenWrite("result.tar.zst"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZstandard(result);
}
}
}
Remarks
harus dapat ditulis.
Exceptions
output’ is null.
output’ is not writable.
SaveZstandard(Tertarik atau Tertarik?)
Simpan file ke file dengan kompresi Zstandard.
public void SaveZstandard(string path, TarFormat? format = null)
Parameters
path
string
Jika nama file yang ditentukan menunjuk ke file yang ada, itu akan ditulis kembali.
format
TarFormat
?
Definisikan format tajuk tar. nilai nol akan diperlakukan sebagai USTar bila mungkin.
Examples
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZstandard("result.tar.zst");
}
}
Exceptions
Panggilan tidak memiliki izin yang diperlukan. -or- path’ ditentukan file atau direktori yang hanya dibaca.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Contohnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
path’ yang ditentukan tidak sah, (misalnya, itu pada drive yang tidak dipaparkan).
path’ is in an invalid format.