Class TarArchive
Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)
Kelas ini mewakili file arsip tar. Gunakan untuk menyusun, mengekstrak, atau memperbarui arsip tar.
public class TarArchive : IArchive, IDisposable
Pewarisan
Mengimplementasikan
Anggota yang Dwarisi
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktor
TarArchive()
Menginisialisasi instance baru dari kelas Aspose.Zip.Tar.TarArchive.
public TarArchive()
Contoh
Contoh berikut menunjukkan cara mengompres file.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
Menginisialisasi instance baru dari kelas Aspose.Zip.Archive dan menyusun daftar entri yang dapat diekstrak dari arsip.
public TarArchive(Stream sourceStream)
Parameter
sourceStream
Stream
Sumber dari arsip. Harus dapat dicari.
Contoh
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
Keterangan
Konstruktor ini tidak membongkar entri apa pun. Lihat metode Aspose.Zip.Tar.TarEntry.Open untuk membongkar.
Pengecualian
sourceStream
tidak dapat dicari.
TarArchive(string)
Menginisialisasi instance baru dari kelas Aspose.Zip.Tar.TarArchive dan menyusun daftar entri yang dapat diekstrak dari arsip.
public TarArchive(string path)
Parameter
path
string
Jalur ke file arsip.
Contoh
Contoh berikut menunjukkan cara mengekstrak semua entri ke direktori.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Keterangan
Konstruktor ini tidak membongkar entri apa pun. Lihat metode Aspose.Zip.Tar.TarEntry.Open untuk membongkar.
Pengecualian
path
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.
path
kosong, hanya berisi spasi, atau berisi 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, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
File di path
mengandung titik dua (:) di tengah string.
File tidak ditemukan.
Jalur yang ditentukan tidak valid, seperti berada di drive yang tidak terpetakan.
File sudah terbuka.
Properti
Entries
Mendapatkan entri dari tipe Aspose.Zip.Tar.TarEntry yang membentuk arsip.
public ReadOnlyCollection<tarentry> Entries { get; }
Nilai Properti
ReadOnlyCollection<TarEntry>
Metode
CreateEntries(DirectoryInfo, bool)
Menambahkan semua file dan direktori secara rekursif ke dalam arsip di direktori yang diberikan.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
Parameter
directory
DirectoryInfo
Direktori untuk dikompres.
includeRootDirectory
bool
Menunjukkan apakah harus menyertakan direktori root itu sendiri atau tidak.
Mengembalikan
Arsip dengan entri yang disusun.
Contoh
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(string, bool)
Menambahkan semua file dan direktori secara rekursif ke dalam arsip di direktori yang diberikan.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
Parameter
sourceDirectory
string
Direktori untuk dikompres.
includeRootDirectory
bool
Menunjukkan apakah harus menyertakan direktori root itu sendiri atau tidak.
Mengembalikan
Arsip dengan entri yang disusun.
Contoh
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(tarFile);
}
}
Pengecualian
sourceDirectory
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses sourceDirectory
.
sourceDirectory
mengandung karakter yang tidak valid seperti “, <, >, atau |.
path
, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter. Jalur yang ditentukan, nama file, atau keduanya terlalu panjang.
CreateEntry(string, Stream, FileSystemInfo)
Buat entri tunggal dalam arsip.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
Parameter
name
string
Nama entri.
source
Stream
Aliran masukan untuk entri.
fileInfo
FileSystemInfo
Metadata file atau folder yang akan dikompres.
Mengembalikan
Instansi entri Tar.
Contoh
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
Keterangan
Nama entri ditetapkan hanya dalam parameter name
. Nama file yang diberikan dalam parameter fileInfo
tidak mempengaruhi nama entri.
fileInfo
dapat merujuk ke System.IO.DirectoryInfo jika entri adalah direktori.
Pengecualian
name
terlalu panjang untuk tar sesuai dengan standar IEEE 1003.1-1998.
Nama file, sebagai bagian dari name
, melebihi 100 simbol.
CreateEntry(string, FileInfo, bool)
Buat entri tunggal dalam arsip.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
Parameter
name
string
Nama entri.
fileInfo
FileInfo
Metadata file atau folder yang akan dikompres.
openImmediately
bool
True jika membuka file segera, jika tidak buka file saat arsip disimpan.
Mengembalikan
Instansi entri Tar.
Contoh
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
Keterangan
Nama entri ditetapkan hanya dalam parameter name
. Nama file yang diberikan dalam parameter fileInfo
tidak mempengaruhi nama entri.
fileInfo
dapat merujuk ke System.IO.DirectoryInfo jika entri adalah direktori.
Jika file dibuka segera dengan parameter openImmediately
, file tersebut akan terblokir hingga arsip dibuang.
Pengecualian
name
terlalu panjang untuk tar sesuai dengan standar IEEE 1003.1-1998.
Nama file, sebagai bagian dari name
, melebihi 100 simbol.
CreateEntry(string, string, bool)
Buat entri tunggal dalam arsip.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
Parameter
name
string
Nama entri.
path
string
Jalur ke file yang akan dikompres.
openImmediately
bool
True jika membuka file segera, jika tidak buka file saat arsip disimpan.
Mengembalikan
Instansi entri Tar.
Contoh
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
Keterangan
Nama entri ditetapkan hanya dalam parameter name
. Nama file yang diberikan dalam parameter path
tidak mempengaruhi nama entri.
Jika file dibuka segera dengan parameter openImmediately
, file tersebut akan terblokir hingga arsip dibuang.
Pengecualian
path
adalah null.
Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.
path
kosong, hanya berisi spasi, atau berisi karakter yang tidak valid. - atau - Nama file, sebagai bagian dari name
, melebihi 100 simbol.
Akses ke file path
ditolak.
path
, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter. - atau - name
terlalu panjang untuk tar sesuai dengan standar IEEE 1003.1-1998.
File di path
mengandung titik dua (:) di tengah string.
DeleteEntry(TarEntry)
Menghapus kemunculan pertama dari entri tertentu dari daftar entri.
public TarArchive DeleteEntry(TarEntry entry)
Parameter
entry
TarEntry
Entri yang akan dihapus dari daftar entri.
Mengembalikan
Arsip dengan entri yang dihapus.
Contoh
Berikut adalah cara Anda dapat 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 berdasarkan indeks.
public TarArchive DeleteEntry(int entryIndex)
Parameter
entryIndex
int
Indeks berbasis nol dari entri yang akan dihapus.
Mengembalikan
Arsip dengan entri yang dihapus.
Contoh
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Pengecualian
entryIndex
kurang dari 0.-atau- entryIndex
sama dengan atau lebih besar dari Entries
count.
Dispose()
Melakukan tugas yang ditentukan oleh aplikasi yang terkait dengan membebaskan, melepaskan, atau mengatur ulang sumber daya yang tidak dikelola.
public void Dispose()
Dispose(bool)
Melakukan tugas yang ditentukan oleh aplikasi yang terkait dengan membebaskan, melepaskan, atau mengatur ulang sumber daya yang tidak dikelola.
protected virtual void Dispose(bool disposing)
Parameter
disposing
bool
Apakah sumber daya yang dikelola harus dibuang.
ExtractToDirectory(string)
Mengekstrak semua file dalam arsip ke direktori yang diberikan.
public void ExtractToDirectory(string destinationDirectory)
Parameter
destinationDirectory
string
Jalur ke direktori untuk menempatkan file yang diekstrak.
Contoh
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Keterangan
Jika direktori tidak ada, direktori tersebut akan dibuat.
Pengecualian
path adalah null
path
, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, pada platform berbasis Windows, jalur 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, jalur mengandung karakter titik dua (:) yang bukan bagian dari label drive (“C:").
path adalah string dengan panjang nol, hanya berisi spasi, atau berisi 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 mengandung, karakter titik dua (:).
Direktori yang ditentukan oleh path adalah file. -atau- Nama jaringan tidak diketahui.
FromGZip(Stream)
Mengekstrak arsip gzip yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip gzip sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromGZip(Stream source)
Parameter
source
Stream
Sumber dari arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Aliran ekstraksi GZip secara alami tidak dapat dicari. Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
Pengecualian
Arsip rusak.
FromGZip(string)
Mengekstrak arsip gzip yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip gzip sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromGZip(string path)
Parameter
path
string
Jalur ke file arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Aliran ekstraksi GZip secara alami tidak dapat dicari. Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
Pengecualian
Arsip rusak.
FromLZMA(Stream)
Mengekstrak arsip LZMA yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip LZMA sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromLZMA(Stream source)
Parameter
source
Stream
Sumber dari arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Aliran ekstraksi LZMA secara alami tidak dapat dicari. Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromLZMA(string)
Mengekstrak arsip LZMA yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip LZMA sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromLZMA(string path)
Parameter
path
string
Jalur ke file arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Aliran ekstraksi LZMA secara alami tidak dapat dicari. Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromLZip(Stream)
Mengekstrak arsip lzip yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip lzip sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromLZip(Stream source)
Parameter
source
Stream
Sumber dari arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Aliran ekstraksi lzip secara alami tidak dapat dicari. Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromLZip(string)
Mengekstrak arsip lzip yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip lzip sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromLZip(string path)
Parameter
path
string
Jalur ke file arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Aliran ekstraksi lzip secara alami tidak dapat dicari. Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromXz(Stream)
Mengekstrak arsip format xz yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip xz sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromXz(Stream source)
Parameter
source
Stream
Sumber dari arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromXz(string)
Mengekstrak arsip format xz yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip xz sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromXz(string path)
Parameter
path
string
Jalur ke file arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromZ(Stream)
Mengekstrak arsip format Z yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip Z sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromZ(Stream source)
Parameter
source
Stream
Sumber dari arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromZ(string)
Mengekstrak arsip format Z yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip Z sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromZ(string path)
Parameter
path
string
Jalur ke file arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Keterangan
Arsip Tar menyediakan fasilitas untuk mengekstrak catatan sembarang, sehingga harus beroperasi pada aliran yang dapat dicari di bawah kap.
FromZstandard(Stream)
Mengekstrak arsip Zstandard yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip Zstandard sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromZstandard(Stream source)
Parameter
source
Stream
Sumber dari arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Pengecualian
Aliran Zstandard rusak atau tidak dapat dibaca.
Data rusak.
FromZstandard(string)
Mengekstrak arsip Zstandard yang disuplai dan menyusun Aspose.Zip.Tar.TarArchive dari data yang diekstrak.
Penting: arsip Zstandard sepenuhnya diekstrak dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
public static TarArchive FromZstandard(string path)
Parameter
path
string
Jalur ke file arsip.
Mengembalikan
Sebuah instance dari Aspose.Zip.Tar.TarArchive
Pengecualian
Aliran Zstandard rusak atau tidak dapat dibaca.
Data rusak.
Save(Stream, TarFormat?)
Menyimpan arsip ke aliran yang diberikan.
public void Save(Stream output, TarFormat? format = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
Keterangan
output
harus dapat ditulis.
Pengecualian
output
tidak dapat ditulis. - atau - output
adalah aliran yang sama dari mana kita mengekstrak.
- ATAU -
Tidak mungkin untuk menyimpan arsip dalam format
karena batasan format.
Save(string, TarFormat?)
Menyimpan arsip ke file tujuan yang diberikan.
public void Save(string destinationFileName, TarFormat? format = null)
Parameter
destinationFileName
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
Keterangan
Dimungkinkan untuk menyimpan arsip ke jalur yang sama seperti saat dimuat. Namun, ini tidak disarankan karena pendekatan ini menggunakan penyalinan ke file sementara.
Pengecualian
destinationFileName
adalah string dengan panjang nol, hanya berisi spasi, atau berisi satu atau lebih karakter yang tidak valid seperti yang ditentukan oleh System.IO.Path.InvalidPathChars.
destinationFileName
adalah null.
destinationFileName
, nama file, atau keduanya melebihi panjang maksimum yang ditentukan oleh sistem. Misalnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
destinationFileName
yang ditentukan tidak valid, (misalnya, berada di drive yang tidak terpetakan).
Terjadi kesalahan I/O saat membuka file.
destinationFileName
menunjuk ke file yang hanya bisa dibaca dan aksesnya bukan Read.-atau- jalur yang ditentukan adalah direktori.-atau- Pemanggil tidak memiliki izin yang diperlukan.
destinationFileName
dalam format yang tidak valid.
File tidak ditemukan.
SaveGzipped(Stream, TarFormat?)
Menyimpan arsip ke aliran dengan kompresi gzip.
public void SaveGzipped(Stream output, TarFormat? format = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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);
}
}
}
Keterangan
output
harus dapat ditulis.
Pengecualian
output
adalah null.
output
tidak dapat ditulis.
SaveGzipped(string, TarFormat?)
Menyimpan arsip ke file berdasarkan jalur dengan kompresi gzip.
public void SaveGzipped(string path, TarFormat? format = null)
Parameter
path
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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");
}
}
SaveLZMACompressed(Stream, TarFormat?)
Menyimpan arsip ke aliran dengan kompresi LZMA.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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);
}
}
}
Keterangan
output
harus dapat ditulis.
Pengecualian
output
adalah null.
output
tidak dapat ditulis.
SaveLZMACompressed(string, TarFormat?)
Menyimpan arsip ke file berdasarkan jalur dengan kompresi lzma.
public void SaveLZMACompressed(string path, TarFormat? format = null)
Parameter
path
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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");
}
}
Keterangan
Penting: arsip tar disusun lalu dikompresi dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.
SaveLzipped(Stream, TarFormat?)
Menyimpan arsip ke aliran dengan kompresi lzip.
public void SaveLzipped(Stream output, TarFormat? format = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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);
}
}
}
Keterangan
output
harus dapat ditulis.
Pengecualian
output
adalah null.
output
tidak dapat ditulis.
SaveLzipped(string, TarFormat?)
Menyimpan arsip ke file berdasarkan jalur dengan kompresi lzip.
public void SaveLzipped(string path, TarFormat? format = null)
Parameter
path
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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");
}
}
SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)
Menyimpan arsip ke aliran dengan kompresi xz.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
settings
XzArchiveSettings
Sekumpulan pengaturan arsip xz tertentu: ukuran kamus, ukuran blok, jenis pemeriksaan.
Contoh
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);
}
}
}
Keterangan
output
Aliran harus dapat ditulis.
Pengecualian
output
adalah null.
output
tidak dapat ditulis.
SaveXzCompressed(string, TarFormat?, XzArchiveSettings)
Menyimpan arsip ke jalur berdasarkan jalur dengan kompresi xz.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
Parameter
path
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
settings
XzArchiveSettings
Sekumpulan pengaturan arsip xz tertentu: ukuran kamus, ukuran blok, jenis pemeriksaan.
Contoh
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");
}
}
SaveZCompressed(Stream, TarFormat?)
Menyimpan arsip ke aliran dengan kompresi Z.
public void SaveZCompressed(Stream output, TarFormat? format = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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);
}
}
}
Keterangan
output
harus dapat ditulis.
Pengecualian
output
adalah null.
output
tidak dapat ditulis.
SaveZCompressed(string, TarFormat?)
Menyimpan arsip ke jalur berdasarkan jalur dengan kompresi Z.
public void SaveZCompressed(string path, TarFormat? format = null)
Parameter
path
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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");
}
}
SaveZstandard(Stream, TarFormat?)
Menyimpan arsip ke aliran dengan kompresi Zstandard.
public void SaveZstandard(Stream output, TarFormat? format = null)
Parameter
output
Stream
Aliran tujuan.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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);
}
}
}
Keterangan
output
harus dapat ditulis.
Pengecualian
output
adalah null.
output
tidak dapat ditulis.
SaveZstandard(string, TarFormat?)
Menyimpan arsip ke file berdasarkan jalur dengan kompresi Zstandard.
public void SaveZstandard(string path, TarFormat? format = null)
Parameter
path
string
Jalur arsip yang akan dibuat. Jika nama file yang ditentukan mengarah ke file yang sudah ada, file tersebut akan ditimpa.
format
TarFormat?
Menentukan format header tar. Nilai null akan diperlakukan sebagai USTar jika memungkinkan.
Contoh
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");
}
}