TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

Buat satu entri dalam arsip.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ParameterJenisKeterangan
nameStringNama entri.
sourceStreamAliran input untuk entri.
fileInfoFileSystemInfoMetadata file atau folder yang akan dikompresi.

Nilai Pengembalian

Contoh entri tar.

Pengecualian

pengecualiankondisi
PathTooLongExceptionname terlalu panjang untuk tar pada standar IEEE 1003.1-1998.
ArgumentExceptionNama file, sebagai bagian dariname, melebihi 100 simbol.

Perkataan

Nama entri hanya diatur di dalamname parameter. Nama file yang disediakan difileInfo parameter tidak mempengaruhi nama entri.

fileInfo dapat merujuk keDirectoryInfo jika entri adalah direktori.

Contoh

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Lihat juga


CreateEntry(string, FileInfo, bool)

Buat satu entri dalam arsip.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParameterJenisKeterangan
nameStringNama entri.
fileInfoFileInfoMetadata file atau folder yang akan dikompresi.
openImmediatelyBooleanBenar jika langsung buka file, jika tidak buka file di penyimpanan arsip.

Nilai Pengembalian

Contoh entri tar.

Pengecualian

pengecualiankondisi
PathTooLongExceptionname terlalu panjang untuk tar pada standar IEEE 1003.1-1998.
ArgumentExceptionNama file, sebagai bagian dariname, melebihi 100 simbol.

Perkataan

Nama entri hanya diatur di dalamname parameter. Nama file yang disediakan difileInfo parameter tidak mempengaruhi nama entri.

fileInfo dapat merujuk keDirectoryInfo jika entri adalah direktori.

Jika file segera dibuka denganopenImmediatelyparameter itu menjadi diblokir sampai arsip dibuang.

Contoh

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Lihat juga


CreateEntry(string, string, bool)

Buat satu entri dalam arsip.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ParameterJenisKeterangan
nameStringNama entri.
pathStringPath ke file yang akan dikompresi.
openImmediatelyBooleanBenar jika langsung buka file, jika tidak buka file di penyimpanan arsip.

Nilai Pengembalian

Contoh entri tar.

Pengecualian

pengecualiankondisi
ArgumentNullExceptionpath adalah nol.
SecurityExceptionPenelepon tidak memiliki izin yang diperlukan untuk mengakses.
ArgumentExceptionItupath kosong, hanya berisi spasi putih, atau berisi karakter yang tidak valid. - atau - Nama file, sebagai bagian dariname, melebihi 100 simbol.
UnauthorizedAccessExceptionAkses ke filepath ditolak.
PathTooLongExceptionYang ditentukanpath , nama file, atau keduanya melebihi panjang maksimum yang ditentukan 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 pada standar IEEE 1003.1-1998.
NotSupportedExceptionBerkas dipath berisi titik dua (:) di tengah string.

Perkataan

Nama entri hanya diatur di dalamname parameter. Nama file yang disediakan dipath parameter tidak mempengaruhi nama entri.

Jika file segera dibuka denganopenImmediatelyparameter itu menjadi diblokir sampai arsip dibuang.

Contoh

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

Lihat juga