Class TarArchive

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

object TarArchive

Implements

IArchive , IDisposable

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

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

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

ArgumentNullException

path’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor na path’ obsahuje stĺpec (:) v strede riadku.

FileNotFoundException

Súbor sa nenašiel.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

IOException

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

TarArchive

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

TarArchive

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

ArgumentNullException

sourceDirectory’ is null.

SecurityException

Volávač nemá požadované povolenie na prístup k sourceDirectory'.

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

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

TarEntry

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

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

TarEntry

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

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

TarEntry

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

ArgumentNullException

path’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

path’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky. - alebo - Názov súboru, ako súčasť name’, presahuje 100 symbolov.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

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

TarArchive

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

TarArchive

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

ArgumentOutOfRangeException

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

ArgumentNullException

Cesta je nulová

PathTooLongException

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.

SecurityException

Návštevník nemá požadované povolenie na prístup k existujúcemu adresáru.

NotSupportedException

Ak adresár neexistuje, cesta obsahuje znak kolónu (:) ktorý nie je súčasťou označenia disku (“C:”).

ArgumentException

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

IOException

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

TarArchive

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

InvalidDataException

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

TarArchive

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

ArgumentNullException

path’ is null.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

Súbor sa nenašiel.

InvalidDataException

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

TarArchive

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

ArgumentNullException

path’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

Súbor sa nenašiel.

EndOfStreamException

Súbor je príliš krátky.

InvalidDataException

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

TarArchive

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

ArgumentException

Nie je možné čítať z source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

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

TarArchive

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

InvalidDataException

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

TarArchive

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

ArgumentNullException

path’ is null.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

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

TarArchive

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

InvalidDataException

Archív je korumpovaný.

ArgumentException

source’ is not seekable.

ArgumentNullException

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

TarArchive

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

ArgumentNullException

path’ is null.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

Súbor sa nenašiel.

InvalidDataException

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

TarArchive

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

TarArchive

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

ArgumentNullException

path’ is null.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

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

TarArchive

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

TarArchive

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

ArgumentNullException

path’ is null.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

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

TarArchive

Príklad z Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Zštandardný prúd je korumpovaný alebo nečitateľný.

InvalidDataException

Ú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

TarArchive

Príklad z Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

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.

NotSupportedException

Súbor v path’ je v neplatnom formáte.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

FileNotFoundException

Súbor sa nenašiel.

IOException

Zštandardný prúd je korumpovaný alebo nečitateľný.

InvalidDataException

Ú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

ArgumentException

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

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený destinationFileName’ je neplatný, (napríklad je to na nezapísanom disku).

IOException

Pri otvorení súboru sa vyskytla chyba I/O.

UnauthorizedAccessException

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.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

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

ArgumentNullException

output’ is null.

ArgumentException

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

UnauthorizedAccessException

Volávač nemá požadované povolenie. -alebo- path’ špecifikovaný iba čítanie súboru alebo adresára.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

Uvedený path’ je neplatný, (napríklad je na nezapísanom disku).

NotSupportedException

path’ is in an invalid format.

 Slovenčina