Class TarArchive

Class TarArchive

Název místa: Aspose.Zip.Tar Sbírka: Aspose.Zip.dll (25.5.0)

Tato třída představuje soubor archivu tar. Použijte ho k sestavování, extrahování nebo aktualizaci archivů Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Dědiční členové

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

TarArchive()

Začíná nový příklad třídy Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

Následující příklad ukazuje, jak komprimovat soubor.

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

TarArchive(Stream)

Začíná nový příklad třídy Aspose.Zip.Archive a sestaví seznam vstupů, které lze extrahovat z archivu.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Zdroje archivu musí být vyhledateln.

Examples

Následující příklad ukazuje, jak extrahovat všechny vstupy do adresáře.

using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Tento výrobce nevybaluje žádné vstupy. viz Aspose.Zip.Tar.TarEntry.Otevřený způsob vybalován.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Stringová)

Začíná nový příklad třídy Aspose.Zip.Tar.tarArchive a sestaví seznam vstupů, které lze extrahovat z archivu.

public TarArchive(string path)

Parameters

path string

Cesta do archivního souboru.

Examples

Následující příklad ukazuje, jak extrahovat všechny vstupy do adresáře.

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Tento výrobce nevybaluje žádné vstupy. viz Aspose.Zip.Tar.TarEntry.Otevřený způsob vybalován.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

FileNotFoundException

Soubor nebyl nalezen.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

IOException

Soubor je již otevřen.

Properties

Entries

Obdrží záznamy typu Aspose.Zip.Tar.TarEntry tvořící archiv.

public ReadOnlyCollection<tarentry> Entries { get; }

Hodnota nemovitosti

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(Úvodní stránka > Bool)

Přidejte do archivu všechny soubory a adresáře opakovaně v daném adresáři.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

Parameters

directory DirectoryInfo

Přihláška k kompresu.

includeRootDirectory bool

Ukazuje, zda zahrnout samotný kořenový adresář nebo ne.

Returns

TarArchive

Archivy s sestavenými příspěvky.

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(Stringová, boolová)

Přidejte do archivu všechny soubory a adresáře opakovaně v daném adresáři.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Parameters

sourceDirectory string

Přihláška k kompresu.

includeRootDirectory bool

Ukazuje, zda zahrnout samotný kořenový adresář nebo ne.

Returns

TarArchive

Archivy s sestavenými příspěvky.

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

Volající nemá požadované povolení k přístupu k sourceDirectory'.

ArgumentException

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

PathTooLongException

Například na platformách založených na Windows musí být trasy menší než 248 znaků a názvy souborů musí být menší než 260 znak.

CreateEntry(String, Stream a FileSystemInfo)

Vytvořte jediný vstup do archivu.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Parameters

name string

Název vstupu.

source Stream

Vstupní proud pro vstup.

fileInfo FileSystemInfo

Metadata souboru nebo složky, které mají být komprimovány.

Returns

TarEntry

Vstupní instance.

Examples

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

Remarks

Vstupní název je nastaven pouze v rámci parametru. název souboru uvedený v parametru nemá vliv na vstupní název.

Můžete odkazovat na System.IO.DirectoryInfo, pokud je záznam adresář.

Exceptions

PathTooLongException

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

ArgumentException

Název souboru, jako součást názvu ”, přesahuje 100 symbol.

CreateEntry(String, FileInfo a bool)

Vytvořte jediný vstup do archivu.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

Parameters

name string

Název vstupu.

fileInfo FileInfo

Metadata souboru nebo složky, které mají být komprimovány.

openImmediately bool

Je pravda, že pokud otevřete soubor okamžitě, jinak otevřete soubor na archivní úspory.

Returns

TarEntry

Vstupní instance.

Examples

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

Remarks

Vstupní název je nastaven pouze v rámci parametru. název souboru uvedený v parametru nemá vliv na vstupní název.

Můžete odkazovat na System.IO.DirectoryInfo, pokud je záznam adresář.

Pokud je soubor otevřen okamžitě s parametrem, blokuje se, dokud není archiv odstraněn.

Exceptions

PathTooLongException

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

ArgumentException

Název souboru, jako součást názvu ", přesahuje 100 symbol.

CreateEntry(String, String a Bool)

Vytvořte jediný vstup do archivu.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Parameters

name string

Název vstupu.

path string

Způsob, jak dosáhnout komprese.

openImmediately bool

Je pravda, že pokud otevřete soubor okamžitě, jinak otevřete soubor na archivní úspory.

Returns

TarEntry

Vstupní instance.

Examples

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

Remarks

Vstupní název je nastaven pouze v rámci parametru. název souboru uvedený v parametru nemá vliv na vstupní název.

Pokud je soubor otevřen okamžitě s parametrem, blokuje se, dokud není archiv odstraněn.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky. - nebo - Název souboru, jako součást name’, přesahuje 100 symbol.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Například na platformách založených na Windows musí být trasy menší než 248 znaků a názvy souborů musí být menší než 260 znaků. - nebo - name’ je příliš dlouhý pro tar, než je standard IEEE 1003.1-1998.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

DeleteEntry(TarEntry)

Odstraňuje první výskyt konkrétního vstupu z seznamu vstup.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Vstup k odstranění z seznamu vstup.

Returns

TarArchive

Archiv s vstupem byl vymazán.

Examples

Zde je, jak můžete odstranit všechny příspěvky s výjimkou posledn:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(Int)

Odstraňuje vstup z seznamu vstupů indexem.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Nulový index vstupu, který je třeba odstranit.

Returns

TarArchive

Archiv s vstupem byl vymazán.

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

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

public void Dispose()

Dispose(Bolíček)

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Je nutné zlikvidovat spravované zdroje.

ExtractToDirectory(Stringová)

Vytahuje všechny soubory v archivu do poskytnutého adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Cesta do adresáře umístit extrahované soubory do.

Examples

Using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Pokud adresář neexistuje, bude vytvořen.

Exceptions

ArgumentNullException

Cesta je nulová

PathTooLongException

Zadaná trasa, název souboru nebo obojí přesahuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasa menší než 248 znaků a název souboru musí být menší než 260 znak.

SecurityException

Návštěvník nemá požadované povolení k přístupu k stávajícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, trasa obsahuje znak kolonu (:) který není součástí označení disku (“C:”).

ArgumentException

Path je řetězec s nulovou délkou, obsahuje pouze bílý prostor, nebo obsahuje jeden nebo více neplatných znaků.Můžete se zeptat na nevhodné znaky pomocí metody System.IO.Path.GetInvalidPithChars. - nebo - cesta je předem nastaven s, anebo obsahuje, pouze znak kolonu (:).

IOException

Řádek určený cestou je soubor. - nebo - Název sítě není znám.

od GZIP(Stream)

Extrakty dodané gzip archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: archiv gzip je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

GZip extrakční proud není vyhledávaný povahou kompresního algoritmu.Tar archiv poskytuje příležitost k extrahování arbitrážního záznamu, takže musí provozovat vyhledávaný tok pod kapotou.

Exceptions

InvalidDataException

Archiv je zkorumpován.

od GZIP(Stringová)

Extrakty dodané gzip archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: archiv gzip je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromGZip(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

GZip extrakční proud není vyhledávaný povahou kompresního algoritmu.Tar archiv poskytuje příležitost k extrahování arbitrážního záznamu, takže musí provozovat vyhledávaný tok pod kapotou.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

InvalidDataException

Archiv je zkorumpován.

od LZ4(Stringová)

Extrakty dodané LZ4 archiv a skládají Aspose.Zip.Tar.tarArchive z extrahovaných dat.

Důležité: LZ4 archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromLZ4(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

LZ4 extrakční proud není vyhledávaný povahou kompresního algoritmu. archiv Tar poskytuje snadnost extrahovat arbitrážní záznam, takže musí provozovat vyhlášený proud pod kapotou.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

EndOfStreamException

Soubor je příliš krátk.

InvalidDataException

Soubor má nesprávný podpis.

od LZ4(Stream)

Extrakty dodané LZ4 archiv a skládají Aspose.Zip.Tar.tarArchive z extrahovaných dat.

Důležité: LZ4 archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

LZ4 extrakční proud není vyhledávaný povahou kompresního algoritmu. archiv Tar poskytuje snadnost extrahovat arbitrážní záznam, takže musí provozovat vyhlášený proud pod kapotou.

Exceptions

ArgumentException

Nelze číst z source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

source" má nesprávný podpis.

od LZMA(Stream)

Extrakty dodané LZMA archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: LZMA archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

LZMA extrakční proud není vyhledávaný povahou kompresního algoritmu. archiv Tar poskytuje možnost vyhledávání arbitrážního záznamu, takže musí provozovat vyhledávaný proud pod kapotou.

Exceptions

InvalidDataException

Archiv je zkorumpován.

od LZMA(Stringová)

Extrakty dodané LZMA archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: LZMA archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromLZMA(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

LZMA extrakční proud není vyhledávaný povahou kompresního algoritmu. archiv Tar poskytuje snadné extrahovat arbitrážní záznam, takže musí provozovat vyhlášený proud pod kapotou.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

od LZIP(Stream)

Extrakty dodané lzip archiv a kompozice Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: archiv lzip je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

Lzip extrakční proud není vyhledávaný povahou kompresního algoritmu. archiv Tar poskytuje možnost vyhledávat arbitrážní záznam, takže musí provozovat vyhledávaný proud pod kapotou.

Exceptions

InvalidDataException

Archiv je zkorumpován.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

od LZIP(Stringová)

Extrakty dodané lzip archiv a kompozice Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: archiv lzip je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromLZip(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

Lzip extrakční proud není vyhledávaný povahou kompresního algoritmu. archiv Tar poskytuje možnost vyhledávat arbitrážní záznam, takže musí provozovat vyhledávaný proud pod kapotou.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

InvalidDataException

Archiv je zkorumpován.

FromXz(Stream)

Extrakty poskytují xz formát archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: xz archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

Tar archiv poskytuje příležitost k extrahování arbitrážního záznamu, takže musí provozovat vyhledávaný tok pod kapotou.

FromXz(Stringová)

Extrakty poskytují xz formát archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: xz archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromXz(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

Tar archiv poskytuje příležitost k extrahování arbitrážního záznamu, takže musí provozovat vyhledávaný tok pod kapotou.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

od Z(Stream)

Extrakty dodané Z formátu archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Z archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

Tar archiv poskytuje příležitost k extrahování arbitrážního záznamu, takže musí provozovat vyhledávaný tok pod kapotou.

od Z(Stringová)

Extrakty dodané Z formátu archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Z archiv je plně extrahována v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromZ(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Remarks

Tar archiv poskytuje příležitost k extrahování arbitrážního záznamu, takže musí provozovat vyhledávaný tok pod kapotou.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

FromZstandard(Stream)

Extrakty dodané Zstandard archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Zstandardní archiv je plně extrahován v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Zdroj z archivu.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Zstandardní proud je zkorumpován nebo nelze číst.

InvalidDataException

Data jsou zkorumpovan.

FromZstandard(Stringová)

Extrakty dodané Zstandard archiv a skládá Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Zstandardní archiv je plně extrahován v rámci této metody, jeho obsah je uchováván interně.

public static TarArchive FromZstandard(string path)

Parameters

path string

Cesta do archivního souboru.

Returns

TarArchive

Příklad aplikace Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path" je v neplatném formátu.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

FileNotFoundException

Soubor nebyl nalezen.

IOException

Zstandardní proud je zkorumpován nebo nelze číst.

InvalidDataException

Data jsou zkorumpovan.

Save(Přívěs a Tarformat?)

Ušetří archiv na poskytnutém toku.

public void Save(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

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 a TarFormat?)

Shromažďuje archiv na poskytnutý cílový soubor.

public void Save(string destinationFileName, TarFormat? format = null)

Parameters

destinationFileName string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli je to možn.

Examples

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Remarks

Je možné uložit archiv na stejnou cestu, jakou byl stažen z. Nicméně, to se nedoporučuje, protože tento přístup používá kopírování do dočasného souboru.

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

Uvedený destinationFileName’, název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasy menší než 248 znaků a název souboru musí být menší než 260 znak.

DirectoryNotFoundException

Uvedený destinationFileName’ je neplatný (např. je na nezapsaném disku).

IOException

Při otevření souboru došlo k chybě 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

Soubor nebyl nalezen.

SaveGzipped(Přívěs a Tarformat?)

Ušetří archiv do toku pomocí gzip komprese.

public void SaveGzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(String a TarFormat?)

Ušetří archiv souboru podle cesty s gzip kompres.

public void SaveGzipped(string path, TarFormat? format = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

SaveLZ4 Komprimované(Přívěs a Tarformat?)

Ušetří archiv do toku s kompresí LZ4.

public void SaveLZ4Compressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4 Komprimované(String a TarFormat?)

Ušetří archiv souboru podle cesty s kompresí LZ4.

public void SaveLZ4Compressed(string path, TarFormat? format = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

Záchranná komprese(Přívěs a Tarformat?)

Ušetří archiv do toku s LZMA kompres.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

Důležité: archiv tar je sestaven a poté komprimován v rámci této metody, jeho obsah je udržován vnitřn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Záchranná komprese(String a TarFormat?)

Ušetří archiv do souboru po cestě s lzma komprese.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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é: archiv tar je sestaven a poté komprimován v rámci této metody, jeho obsah je udržován vnitřn.

Exceptions

UnauthorizedAccessException

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Přívěs a Tarformat?)

Ušetří archiv do toku s lzip kompres.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(String a TarFormat?)

Ušetří archiv do souboru na cestě s lzip kompres.

public void SaveLzipped(string path, TarFormat? format = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Ušetří archiv do toku s xz kompres.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli je to možn.

settings XzArchiveSettings

Soubor nastavení konkrétního xz archivu: velikost slovníku, velikost bloků, 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ůtok musí být písemný.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(String, TarFormat?, XzArchiveSettings)

Ušetří archiv na cestě po cestě s xz kompres.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli je to možn.

settings XzArchiveSettings

Soubor nastavení konkrétního xz archivu: velikost slovníku, velikost bloků, 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

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

Slevová komprese(Přívěs a Tarformat?)

Ušetří archiv do toku s kompresí Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Slevová komprese(String a TarFormat?)

Ušetří archiv na cestě po cestě s kompresí Z.

public void SaveZCompressed(string path, TarFormat? format = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Přívěs a Tarformat?)

Ušetří archiv do toku pomocí standardní komprese.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parameters

output Stream

Destinace v toku.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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í být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(String a TarFormat?)

Ušetří archiv souboru podle cesty se standardní kompres.

public void SaveZstandard(string path, TarFormat? format = null)

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

format TarFormat ?

Definuje tar header formát. nulová hodnota bude považována za USTar kdykoli 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

Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.

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

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

DirectoryNotFoundException

Uvedený path" je neplatný (např. je na nezapsaném disku).

NotSupportedException

path’ is in an invalid format.

 Čeština