Class TarArchive
Pôvodný názov: Aspose.Zip.Tar Zhromaždenie: Aspose.Zip.dll (25.5.0)
Táto trieda predstavuje archív tar. Použite ho na zloženie, extrahovanie, alebo aktualizáciu archívu Tar.
public class TarArchive : IArchive, IDisposable
Inheritance
Implements
Z dedičných členov
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
TarArchive()
Initalizuje novú inštanciu triedy Aspose.Zip.Tar.TarArchive.
public TarArchive()
Examples
Nasledujúci príklad ukazuje, ako komprimovať súbor.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
Initalizuje novú inštanciu triedy Aspose.Zip.Archive a skladá zoznam vstupov, ktoré možno vytiahnuť z archívu.
public TarArchive(Stream sourceStream)
Parameters
sourceStream
Stream
Zdroj archívu, musí byť vyhľadávaný.
Examples
Nasledujúci príklad ukazuje, ako extrahovať všetky záznamy do katalógu.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Tento konštruktor neodbalí žiadny vstup. Pozri Aspose.Zip.Tar.TarEntry.Otvorený spôsob odbalenia.
Exceptions
sourceStream’ is not seekable.
sourceStream’ is null.
TarArchive(Stretnutie)
Initalizuje novú inštanciu triedy Aspose.Zip.Tar.tarArchive a skladá zoznam vstupov, ktoré možno vytiahnuť z archívu.
public TarArchive(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Examples
Nasledujúci príklad ukazuje, ako extrahovať všetky záznamy do katalógu.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Tento konštruktor neodbalí žiadny vstup. Pozri Aspose.Zip.Tar.TarEntry.Otvorený spôsob odbalenia.
Exceptions
path’ is null.
Návštevník nemá požadované povolenie na prístup.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor na path’ obsahuje stĺpec (:) v strede riadku.
Súbor sa nenašiel.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor je už otvorený.
Properties
Entries
Získava záznamy typu Aspose.Zip.Tar.TarEntry, ktorý tvorí archív.
public ReadOnlyCollection<tarentry> Entries { get; }
Hodnota nehnuteľnosti
ReadOnlyCollection < TarEntry >
Methods
CreateEntries(Úvodná stránka > Bool)
Pridajte do archívu všetky súbory a adresáre opakovane v danom adresári.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
Parameters
directory
DirectoryInfo
Príručka na kompresiu.
includeRootDirectory
bool
Ukazuje, či zahŕňať samotný koreňový adresár alebo nie.
Returns
Archív s skladateľnými záznammi.
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(striekačka, bool)
Pridajte do archívu všetky súbory a adresáre opakovane v danom adresári.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
Parameters
sourceDirectory
string
Príručka na kompresiu.
includeRootDirectory
bool
Ukazuje, či zahŕňať samotný koreňový adresár alebo nie.
Returns
Archív s skladateľnými záznammi.
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.
Volávač nemá požadované povolenie na prístup k sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Ustanovená trasa, názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows musia byť trasy menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov. Ustanovená trasa, názov súboru alebo obaja sú príliš dlhé.
CreateEntry(Stretnutie, Stream, FileSystemInfo)
Vytvorte jediný vstup v archíve.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
Parameters
name
string
Názov vstupu.
source
Stream
Vstupný prúd pre vstup.
fileInfo
FileSystemInfo
Metadata súboru alebo priečinka sa majú komprimovať.
Returns
Inštitúcia vstupu.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
Remarks
Názov súboru uvedený v paramete nemá vplyv na názov súboru.
môžete odkazovať na System.IO.DirectoryInfo, ak je záznam adresára.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Názov súboru, ako súčasť názvu ”, presahuje 100 symbolov.
CreateEntry(Príslušenstvo, FileInfo, Bool)
Vytvorte jediný vstup v archíve.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
Parameters
name
string
Názov vstupu.
fileInfo
FileInfo
Metadata súboru alebo priečinka sa majú komprimovať.
openImmediately
bool
Je pravda, že ak otvoríte súbor ihneď, inak otvoríte súbor na archívnom úložisku.
Returns
Inštitúcia vstupu.
Examples
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
Remarks
Názov súboru uvedený v paramete nemá vplyv na názov súboru.
môžete odkazovať na System.IO.DirectoryInfo, ak je záznam adresára.
Ak sa súbor otvorí okamžite s parametrom, blokuje sa až do odstránenia archívu.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Názov súboru, ako súčasť názvu ", presahuje 100 symbolov.
CreateEntry(String, String a Bool)
Vytvorte jediný vstup v archíve.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
Parameters
name
string
Názov vstupu.
path
string
Spôsob, ako dosiahnuť, aby bol komprimovaný.
openImmediately
bool
Je pravda, že ak otvoríte súbor ihneď, inak otvoríte súbor na archívnom úložisku.
Returns
Inštitúcia vstupu.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
Remarks
Názov súboru uvedený v paramete nemá vplyv na názov súboru.
Ak sa súbor otvorí okamžite s parametrom, blokuje sa až do odstránenia archívu.
Exceptions
path’ is null.
Návštevník nemá požadované povolenie na prístup.
path’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky. - alebo - Názov súboru, ako súčasť
name’, presahuje 100 symbolov.
Prístup k súboru path" je zamietnutý.
Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov. - alebo - name’ je príliš dlhý pre tar ako štandard IEEE 1003.1-1998.
Súbor na path’ obsahuje stĺpec (:) v strede riadku.
DeleteEntry(TarEntry)
Odstráni prvý výskyt konkrétneho vstupu z zoznamu vstupov.
public TarArchive DeleteEntry(TarEntry entry)
Parameters
entry
TarEntry
Vstup na odstránenie z zoznamu vstupov.
Returns
Archív s vstupom je odstránený.
Examples
Tu je, ako môžete odstrániť všetky záznamy s výnimkou posledného:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(int)
Odstrániť vstup z vstupného zoznamu podľa indexu.
public TarArchive DeleteEntry(int entryIndex)
Parameters
entryIndex
int
Null-based index vstupu odstrániť.
Returns
Archív s vstupom je odstránený.
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()
Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.
public void Dispose()
Dispose(bool)
Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Mali by sa riadiť riadené zdroje.
ExtractToDirectory(Stretnutie)
Vytiahne všetky súbory v archíve do poskytnutého katalógu.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Cesta do adresára umiestniť extrahované súbory do.
Examples
Using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Ak katalóg neexistuje, vytvorí sa.
Exceptions
Cesta je nulová
Ustanovená trasa, názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows musia byť trasy menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Návštevník nemá požadované povolenie na prístup k existujúcemu adresáru.
Ak adresár neexistuje, cesta obsahuje znak kolónu (:) ktorý nie je súčasťou označenia disku (“C:”).
Path je nula-dlhý prúžok, obsahuje len biely priestor, alebo obsahuje jeden alebo viac neplatných znakov. Môžete požiadať o neplatené znaky pomocou metódy System.IO.Path.GetInvalidPithChars. - alebo - cesta je predpísaná s, či obsahuje, iba znak kolónu (:).
Katalóg špecifikovaný cestou je súbor. - alebo - Názov siete nie je známy.
od GZIP(Stream)
Extrakty dodané gzip archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: gzip archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah sa uchováva internálne.
public static TarArchive FromGZip(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
GZip extrakčný prúd nie je hľadaný povahou kompresného algoritmu.Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
Archív je korumpovaný.
od GZIP(Stretnutie)
Extrakty dodané gzip archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: gzip archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah sa uchováva internálne.
public static TarArchive FromGZip(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
GZip extrakčný prúd nie je hľadaný povahou kompresného algoritmu.Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
path’ is null.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
Archív je korumpovaný.
od LZ4(Stretnutie)
Extrakty dodané LZ4 archív a skladá Aspose.Zip.Tar.tarArchive z extrahovaných údajov.
Dôležité: LZ4 archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromLZ4(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
LZ4 extrakčný prúd nie je hľadaný povahou kompresného algoritmu. archív Tar poskytuje príležitosť na extrahovanie dobrovoľného záznamu, takže musí prevádzkovať vyhľadávacie prúdy pod chvostom.
Exceptions
path’ is null.
Návštevník nemá požadované povolenie na prístup
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
Súbor je príliš krátky.
Súbor má nesprávny podpis.
od LZ4(Stream)
Extrakty dodané LZ4 archív a skladá Aspose.Zip.Tar.tarArchive z extrahovaných údajov.
Dôležité: LZ4 archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromLZ4(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
LZ4 extrakčný prúd nie je hľadaný povahou kompresného algoritmu. archív Tar poskytuje príležitosť na extrahovanie dobrovoľného záznamu, takže musí prevádzkovať vyhľadávacie prúdy pod chvostom.
Exceptions
Nie je možné čítať z source’
source’ is null.
source’ is too short.
Zdroj " má nesprávny podpis.
od LZMA(Stream)
Extrakty dodané LZMA archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: LZMA archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah sa uchováva internálne.
public static TarArchive FromLZMA(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
LZMA extrakčný prúd nie je vyhľadávateľný podľa povahy kompresného algoritmu. archív Tar poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
Archív je korumpovaný.
od LZMA(Stretnutie)
Extrakty dodané LZMA archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: LZMA archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah sa uchováva internálne.
public static TarArchive FromLZMA(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
LZMA extrakčný prúd nie je vyhľadávateľný podľa povahy kompresného algoritmu. archív Tar poskytuje príležitosť na extrahovanie dobrovoľného záznamu, takže musí prevádzkovať hľadaný tok pod šnúrkou.
Exceptions
path’ is null.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
odLZIP(Stream)
Extrakty dodané lzip archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: archív lzip je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromLZip(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
Lzip extrakčný prúd nie je vyhľadávateľný podľa povahy kompresného algoritmu. Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
Archív je korumpovaný.
source’ is not seekable.
source’ is null.
odLZIP(Stretnutie)
Extrakty dodané lzip archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: archív lzip je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromLZip(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
Lzip extrakčný prúd nie je vyhľadávateľný podľa povahy kompresného algoritmu. Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
path’ is null.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
Archív je korumpovaný.
FromXz(Stream)
Extrakty dodané xz formát archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: xz archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromXz(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
FromXz(Stretnutie)
Extrakty dodané xz formát archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: xz archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromXz(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
path’ is null.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
od Z(Stream)
Extrakty dodané Z formát archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: Z archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromZ(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
od Z(Stretnutie)
Extrakty dodané Z formát archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: Z archív je úplne vytiahnutý v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromZ(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Remarks
Tar archív poskytuje príležitosť na extrakciu dobrovoľného záznamu, takže musí prevádzkovať vyhľadávateľný prúd pod kútom.
Exceptions
path’ is null.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
FromZstandard(Stream)
Extrakty dodané Zstandard archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: Zštandardný archív je plne extrahovaný v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromZstandard(Stream source)
Parameters
source
Stream
zdrojom archívu.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Exceptions
Zštandardný prúd je korumpovaný alebo nečitateľný.
Údaje sú korumpované.
FromZstandard(Stretnutie)
Extrakty dodané Zstandard archív a skladá Aspose.Zip.Tar.TarArchive z extrahovaných údajov.
Dôležité: Zštandardný archív je plne extrahovaný v rámci tejto metódy, jeho obsah je uložený internálne.
public static TarArchive FromZstandard(string path)
Parameters
path
string
Cesta k archívnemu súboru.
Returns
Príklad z Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Súbor v path’ je v neplatnom formáte.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor sa nenašiel.
Zštandardný prúd je korumpovaný alebo nečitateľný.
Údaje sú korumpované.
Save(Stream alebo TarFormat?)
Úspora archívov na poskytnutý prúd.
public void Save(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
Remarks
Musí byť písateľná.
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(String alebo TarFormat?)
Uloží archív do poskytnutého cieľového súboru.
public void Save(string destinationFileName, TarFormat? format = null)
Parameters
destinationFileName
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
Remarks
Je možné uložiť archív na rovnakú cestu, ako bola naložená z. Avšak, to sa neodporúča, pretože tento prístup používa kopírovanie do dočasného súboru.
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.
Určená destinationFileName’, názov súboru, alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený destinationFileName’ je neplatný, (napríklad je to na nezapísanom disku).
Pri otvorení súboru sa vyskytla chyba I/O.
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.
Súbor sa nenašiel.
SaveGzipped(Stream alebo TarFormat?)
Ušetrí archív do toku pomocou kompresie gzip.
public void SaveGzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Musí byť písateľná.
Exceptions
output’ is null.
output’ is not writable.
SaveGzipped(String alebo TarFormat?)
Uloží archív do súboru podľa cesty pomocou kompresie gzip.
public void SaveGzipped(string path, TarFormat? format = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.
SaveLZ4Komprimované(Stream alebo TarFormat?)
Ušetrí archív do prúdu pomocou kompresie LZ4.
public void SaveLZ4Compressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Musí byť písateľná.
Exceptions
output’ is null.
output’ is not writable.
SaveLZ4Komprimované(String alebo TarFormat?)
Ušetrí archív do súboru podľa cesty pomocou kompresie LZ4.
public void SaveLZ4Compressed(string path, TarFormat? format = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.
Zľavová kompresia(Stream alebo TarFormat?)
Ušetrí archív do prúdu pomocou kompresie LZMA.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Musí byť písateľná.
Dôležité: archív tar je zložený a potom komprimovaný v rámci tejto metódy, jeho obsah je udržiavaný internálne.
Exceptions
output’ is null.
output’ is not writable.
Zľavová kompresia(String alebo TarFormat?)
Ušetrí archív do súboru podľa cesty s lzma kompresiou.
public void SaveLZMACompressed(string path, TarFormat? format = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Dôležité: archív tar je zložený a potom komprimovaný v rámci tejto metódy, jeho obsah je udržiavaný internálne.
Exceptions
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.
SaveLzipped(Stream alebo TarFormat?)
Ušetrí archív do toku pomocou kompresie lzip.
public void SaveLzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Musí byť písateľná.
Exceptions
output’ is null.
output’ is not writable.
SaveLzipped(String alebo TarFormat?)
Uloží archív do súboru podľa cesty s lzip kompresiou.
public void SaveLzipped(string path, TarFormat? format = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.
SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)
Ušetrí archív do toku pomocou kompresie xz.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
settings
XzArchiveSettings
Súprava nastavenia konkrétneho xz archívu: veľkosť slovníka, veľkosť bloku, typ kontroly.
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
Prúd musí byť písateľný.
Exceptions
output’ is null.
output’ is not writable.
SaveXzCompressed(String, TarFormat?, XzArchiveSettings)
Ušetrí archív na cestu podľa cesty s xz kompresiou.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
settings
XzArchiveSettings
Súprava nastavenia konkrétneho xz archívu: veľkosť slovníka, veľkosť bloku, typ kontroly.
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
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.
SaveZkomprimované(Stream alebo TarFormat?)
Ušetrí archív do prúdu pomocou kompresie Z.
public void SaveZCompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Musí byť písateľná.
Exceptions
output’ is null.
output’ is not writable.
SaveZkomprimované(String alebo TarFormat?)
Ušetrí archív na cestu podľa cesty s kompresou Z.
public void SaveZCompressed(string path, TarFormat? format = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.
SaveZstandard(Stream alebo TarFormat?)
Ušetrí archív do prúdu pomocou štandardnej kompresie.
public void SaveZstandard(Stream output, TarFormat? format = null)
Parameters
output
Stream
Cestovný prúd .
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Musí byť písateľná.
Exceptions
output’ is null.
output’ is not writable.
SaveZstandard(String alebo TarFormat?)
Uloží archív do súboru podľa cesty pomocou štandardnej kompresie.
public void SaveZstandard(string path, TarFormat? format = null)
Parameters
path
string
Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.
format
TarFormat
?
Definuje formát názvu tar. nulová hodnota sa bude zaobchádzať ako USTar, keď je to možné.
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
Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.
Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).
path’ is in an invalid format.