Class TarArchive

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

objectTarArchive

Mengimplementasikan

IArchive, IDisposable

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

InvalidDataException

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

ArgumentNullException

path adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

ArgumentException

path kosong, hanya berisi spasi, atau berisi karakter yang tidak valid.

UnauthorizedAccessException

Akses ke file path ditolak.

PathTooLongException

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.

NotSupportedException

File di path mengandung titik dua (:) di tengah string.

FileNotFoundException

File tidak ditemukan.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid, seperti berada di drive yang tidak terpetakan.

IOException

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&gt;

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

TarArchive

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

TarArchive

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

ArgumentNullException

sourceDirectory adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses sourceDirectory.

ArgumentException

sourceDirectory mengandung karakter yang tidak valid seperti “, <, >, atau |.

PathTooLongException

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

TarEntry

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

PathTooLongException

name terlalu panjang untuk tar sesuai dengan standar IEEE 1003.1-1998.

ArgumentException

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

TarEntry

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

PathTooLongException

name terlalu panjang untuk tar sesuai dengan standar IEEE 1003.1-1998.

ArgumentException

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

TarEntry

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

ArgumentNullException

path adalah null.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan untuk mengakses.

ArgumentException

path kosong, hanya berisi spasi, atau berisi karakter yang tidak valid. - atau - Nama file, sebagai bagian dari name, melebihi 100 simbol.

UnauthorizedAccessException

Akses ke file path ditolak.

PathTooLongException

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.

NotSupportedException

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

TarArchive

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 &gt; 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

TarArchive

Arsip dengan entri yang dihapus.

Contoh

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

Pengecualian

ArgumentOutOfRangeException

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

ArgumentNullException

path adalah null

PathTooLongException

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.

SecurityException

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

NotSupportedException

Jika direktori tidak ada, jalur mengandung karakter titik dua (:) yang bukan bagian dari label drive (“C:").

ArgumentException

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 (:).

IOException

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

TarArchive

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

InvalidDataException

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

TarArchive

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

InvalidDataException

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

Sebuah instance dari Aspose.Zip.Tar.TarArchive

Pengecualian

IOException

Aliran Zstandard rusak atau tidak dapat dibaca.

InvalidDataException

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

TarArchive

Sebuah instance dari Aspose.Zip.Tar.TarArchive

Pengecualian

IOException

Aliran Zstandard rusak atau tidak dapat dibaca.

InvalidDataException

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

ArgumentException

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

ArgumentException

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.

ArgumentNullException

destinationFileName adalah null.

PathTooLongException

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.

DirectoryNotFoundException

destinationFileName yang ditentukan tidak valid, (misalnya, berada di drive yang tidak terpetakan).

IOException

Terjadi kesalahan I/O saat membuka file.

UnauthorizedAccessException

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.

NotSupportedException

destinationFileName dalam format yang tidak valid.

FileNotFoundException

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

ArgumentNullException

output adalah null.

ArgumentException

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.

Penting: arsip tar disusun lalu dikompresi dalam metode ini, kontennya disimpan secara internal. Hati-hati terhadap konsumsi memori.

Pengecualian

ArgumentNullException

output adalah null.

ArgumentException

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

ArgumentNullException

output adalah null.

ArgumentException

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

ArgumentNullException

output adalah null.

ArgumentException

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

ArgumentNullException

output adalah null.

ArgumentException

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

ArgumentNullException

output adalah null.

ArgumentException

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");
    }
}
 Indonesia