Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Tato třída představuje soubor tar archivu. Použijte ji k sestavení, extrakci nebo aktualizaci tar archivů.

public class TarArchive : IArchive, IDisposable

Dědění

objectTarArchive

Implementuje

IArchive, IDisposable

Děděné členy

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

Konstruktor

TarArchive()

Inicializuje novou instanci třídy Aspose.Zip.Tar.TarArchive.

public TarArchive()

Příklady

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)

Inicializuje novou instanci třídy Aspose.Zip.Archive a sestavuje seznam položek, které lze extrahovat z archivu.

public TarArchive(Stream sourceStream)

Parametry

sourceStream Stream

Zdroj archivu. Musí být vyhledatelný.

Příklady

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

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

Poznámky

Tento konstruktor neprovádí rozbalení žádné položky. Viz metoda Aspose.Zip.Tar.TarEntry.Open pro rozbalení.

Výjimky

InvalidDataException

sourceStream není vyhledatelný.

TarArchive(string)

Inicializuje novou instanci třídy Aspose.Zip.Tar.TarArchive a sestavuje seznam položek, které lze extrahovat z archivu.

public TarArchive(string path)

Parametry

path string

Cesta k souboru archivu.

Příklady

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

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

Poznámky

Tento konstruktor neprovádí rozbalení žádné položky. Viz metoda Aspose.Zip.Tar.TarEntry.Open pro rozbalení.

Výjimky

ArgumentNullException

path je null.

SecurityException

Volající nemá potřebné oprávnění k přístupu.

ArgumentException

path je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path je odepřen.

PathTooLongException

Zadaná path, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.

NotSupportedException

Soubor na path obsahuje dvojtečku (:) uprostřed řetězce.

FileNotFoundException

Soubor nebyl nalezen.

DirectoryNotFoundException

Zadaná cesta je neplatná, například se nachází na nepřiřazeném disku.

IOException

Soubor je již otevřen.

Vlastnosti

Entries

Získá položky typu Aspose.Zip.Tar.TarEntry, které tvoří archiv.

public ReadOnlyCollection<tarentry> Entries { get; }

Hodnota vlastnosti

ReadOnlyCollection<TarEntry&gt;

Metody

CreateEntries(DirectoryInfo, bool)

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

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

Parametry

directory DirectoryInfo

Adresář k zkomprimování.

includeRootDirectory bool

Určuje, zda zahrnout samotný kořenový adresář nebo ne.

Vrací

TarArchive

Archiv se složenými položkami.

Příklady

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(tarFile);
    }
}

CreateEntries(string, bool)

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

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

Parametry

sourceDirectory string

Adresář k zkomprimování.

includeRootDirectory bool

Určuje, zda zahrnout samotný kořenový adresář nebo ne.

Vrací

TarArchive

Archiv se složenými položkami.

Příklady

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

Výjimky

ArgumentNullException

sourceDirectory je null.

SecurityException

Volající nemá potřebné oprávnění k přístupu sourceDirectory.

ArgumentException

sourceDirectory obsahuje neplatné znaky, jako jsou “, <, > nebo |.

PathTooLongException

Zadaná cesta, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků. Zadaná cesta, název souboru, nebo obojí jsou příliš dlouhé.

CreateEntry(string, Stream, FileSystemInfo)

Vytvoří jednotlivou položku v archivu.

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

Parametry

name string

Název položky.

source Stream

Vstupní proud pro položku.

fileInfo FileSystemInfo

Metadata souboru nebo složky, která má být zkomprimována.

Vrací

TarEntry

Instance položky Tar.

Příklady

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

Poznámky

Název položky je určen pouze parametrem name. Název souboru uvedený v parametru fileInfo nemá vliv na název položky.

fileInfo může odkazovat na System.IO.DirectoryInfo, pokud je položka adresář.

Výjimky

PathTooLongException

name je příliš dlouhé pro tar podle standardu IEEE 1003.1-1998.

ArgumentException

Název souboru, jako součást name, překračuje 100 symbolů.

CreateEntry(string, FileInfo, bool)

Vytvoří jednotlivou položku v archivu.

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

Parametry

name string

Název položky.

fileInfo FileInfo

Metadata souboru nebo složky, která má být zkomprimována.

openImmediately bool

True, pokud se má soubor otevřít okamžitě, jinak se soubor otevře při ukládání archivu.

Vrací

TarEntry

Instance položky Tar.

Příklady

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

Poznámky

Název položky je určen pouze parametrem name. Název souboru uvedený v parametru fileInfo nemá vliv na název položky.

fileInfo může odkazovat na System.IO.DirectoryInfo, pokud je položka adresář.

Pokud je soubor otevřen okamžitě pomocí parametru openImmediately, zůstane blokován, dokud nebude archiv zlikvidován.

Výjimky

PathTooLongException

name je příliš dlouhé pro tar podle standardu IEEE 1003.1-1998.

ArgumentException

Název souboru, jako součást name, překračuje 100 symbolů.

CreateEntry(string, string, bool)

Vytvoří jednotlivou položku v archivu.

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

Parametry

name string

Název položky.

path string

Cesta k souboru, který má být zkomprimován.

openImmediately bool

True, pokud se má soubor otevřít okamžitě, jinak se soubor otevře při ukládání archivu.

Vrací

TarEntry

Instance položky Tar.

Příklady

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

Poznámky

Název položky je určen pouze parametrem name. Název souboru uvedený v parametru path nemá vliv na název položky.

Pokud je soubor otevřen okamžitě pomocí parametru openImmediately, zůstane blokován, dokud nebude archiv zlikvidován.

Výjimky

ArgumentNullException

path je null.

SecurityException

Volající nemá potřebné oprávnění k přístupu.

ArgumentException

path je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky. - nebo - Název souboru, jako součást name, překračuje 100 symbolů.

UnauthorizedAccessException

Přístup k souboru path je odepřen.

PathTooLongException

Zadaná path, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků. - nebo - name je příliš dlouhé pro tar podle standardu IEEE 1003.1-1998.

NotSupportedException

Soubor na path obsahuje dvojtečku (:) uprostřed řetězce.

DeleteEntry(TarEntry)

Odstraní první výskyt konkrétní položky ze seznamu položek.

public TarArchive DeleteEntry(TarEntry entry)

Parametry

entry TarEntry

Položka, kterou je třeba odstranit ze seznamu položek.

Vrací

TarArchive

Archiv s odstraněnou položkou.

Příklady

Zde je, jak můžete odstranit všechny položky kromě poslední:

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

DeleteEntry(int)

Odstraní položku ze seznamu položek podle indexu.

public TarArchive DeleteEntry(int entryIndex)

Parametry

entryIndex int

Nula založený index položky, kterou je třeba odstranit.

Vrací

TarArchive

Archiv s odstraněnou položkou.

Příklady

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

Výjimky

ArgumentOutOfRangeException

entryIndex je menší než 0. - nebo - entryIndex je rovno nebo větší než počet Entries.

Dispose()

Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.

public void Dispose()

Dispose(bool)

Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

Zda by měly být uvolněny řízené prostředky.

ExtractToDirectory(string)

Extrahuje všechny soubory v archivu do zadaného adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Cesta k adresáři, do kterého mají být umístěny extrahované soubory.

Příklady

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

Poznámky

Pokud adresář neexistuje, bude vytvořen.

Výjimky

ArgumentNullException

cesta je null.

PathTooLongException

Zadaná cesta, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.

SecurityException

Volající nemá potřebné oprávnění k přístupu k existujícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí označení disku (“C:").

ArgumentException

cesta je řetězec nulové délky, obsahuje pouze bílé znaky nebo obsahuje jeden nebo více neplatných znaků. Můžete dotazovat neplatné znaky pomocí metody System.IO.Path.GetInvalidPathChars. - nebo - cesta je předponová, nebo obsahuje pouze znak dvojtečky (:).

IOException

Adresář určený pomocí cesty je soubor. - nebo - Síťový název není znám.

FromGZip(Stream)

Extrahuje dodaný gzip archiv a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: gzip archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromGZip(Stream source)

Parametry

source Stream

Zdroj archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Proud pro extrakci GZip není vyhledatelný z povahy kompresního algoritmu. Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

Výjimky

InvalidDataException

Archiv je poškozen.

FromGZip(string)

Extrahuje dodaný gzip archiv a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: gzip archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromGZip(string path)

Parametry

path string

Cesta k souboru archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Proud pro extrakci GZip není vyhledatelný z povahy kompresního algoritmu. Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

Výjimky

InvalidDataException

Archiv je poškozen.

FromLZMA(Stream)

Extrahuje dodaný LZMA archiv a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: LZMA archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromLZMA(Stream source)

Parametry

source Stream

Zdroj archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Proud pro extrakci LZMA není vyhledatelný z povahy kompresního algoritmu. Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromLZMA(string)

Extrahuje dodaný LZMA archiv a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: LZMA archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromLZMA(string path)

Parametry

path string

Cesta k souboru archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Proud pro extrakci LZMA není vyhledatelný z povahy kompresního algoritmu. Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromLZip(Stream)

Extrahuje dodaný lzip archiv a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: lzip archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromLZip(Stream source)

Parametry

source Stream

Zdroj archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Proud pro extrakci lzip není vyhledatelný z povahy kompresního algoritmu. Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromLZip(string)

Extrahuje dodaný lzip archiv a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: lzip archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromLZip(string path)

Parametry

path string

Cesta k souboru archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Proud pro extrakci lzip není vyhledatelný z povahy kompresního algoritmu. Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromXz(Stream)

Extrahuje dodaný archiv ve formátu xz a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: xz archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromXz(Stream source)

Parametry

source Stream

Zdroj archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromXz(string)

Extrahuje dodaný archiv ve formátu xz a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: xz archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromXz(string path)

Parametry

path string

Cesta k souboru archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromZ(Stream)

Extrahuje dodaný archiv ve formátu Z a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Z archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromZ(Stream source)

Parametry

source Stream

Zdroj archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromZ(string)

Extrahuje dodaný archiv ve formátu Z a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Z archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromZ(string path)

Parametry

path string

Cesta k souboru archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Poznámky

Tar archiv poskytuje možnost extrahovat libovolný záznam, takže musí pracovat s vyhledatelným proudem pod kapotou.

FromZstandard(Stream)

Extrahuje dodaný archiv ve formátu Zstandard a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Zstandard archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromZstandard(Stream source)

Parametry

source Stream

Zdroj archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Výjimky

IOException

Zstandard proud je poškozený nebo nečitelný.

InvalidDataException

Data jsou poškozená.

FromZstandard(string)

Extrahuje dodaný archiv ve formátu Zstandard a sestavuje Aspose.Zip.Tar.TarArchive z extrahovaných dat.

Důležité: Zstandard archiv je plně extrahován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

public static TarArchive FromZstandard(string path)

Parametry

path string

Cesta k souboru archivu.

Vrací

TarArchive

Instance Aspose.Zip.Tar.TarArchive

Výjimky

IOException

Zstandard proud je poškozený nebo nečitelný.

InvalidDataException

Data jsou poškozená.

Save(Stream, TarFormat?)

Uloží archiv do poskytnutého proudu.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Poznámky

output musí být zapisovatelný.

Výjimky

ArgumentException

output není zapisovatelný. - nebo - output je stejný proud, ze kterého extrahujeme. - NEBO - Není možné uložit archiv v format kvůli omezením formátu.

Save(string, TarFormat?)

Uloží archiv do cílového souboru podle zadané cesty.

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

Parametry

destinationFileName string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

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

Výjimky

ArgumentException

destinationFileName je řetězec nulové délky, obsahuje pouze bílé znaky nebo obsahuje jeden nebo více neplatných znaků definovaných System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName je null.

PathTooLongException

Zadaná destinationFileName, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.

DirectoryNotFoundException

Zadaná destinationFileName je neplatná, (například se nachází na nepřiřazeném disku).

IOException

Došlo k chybě I/O při otevírání souboru.

UnauthorizedAccessException

destinationFileName určil soubor, který je pouze pro čtení a přístup není povolen. - nebo - cesta určuje adresář. - nebo - Volající nemá potřebná oprávnění.

NotSupportedException

destinationFileName je v neplatném formátu.

FileNotFoundException

Soubor nebyl nalezen.

SaveGzipped(Stream, TarFormat?)

Uloží archiv do proudu s gzip kompresí.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

output musí být zapisovatelný.

Výjimky

ArgumentNullException

output je null.

ArgumentException

output není zapisovatelný.

SaveGzipped(string, TarFormat?)

Uloží archiv do souboru podle cesty s gzip kompresí.

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

Parametry

path string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

Uloží archiv do proudu s LZMA kompresí.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

output musí být zapisovatelný.

Důležité: tar archiv je sestaven a poté komprimován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

Výjimky

ArgumentNullException

output je null.

ArgumentException

output není zapisovatelný.

SaveLZMACompressed(string, TarFormat?)

Uloží archiv do souboru podle cesty s lzma kompresí.

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

Parametry

path string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

Důležité: tar archiv je sestaven a poté komprimován v této metodě, jeho obsah je uchováván interně. Dávejte pozor na spotřebu paměti.

SaveLzipped(Stream, TarFormat?)

Uloží archiv do proudu s lzip kompresí.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

output musí být zapisovatelný.

Výjimky

ArgumentNullException

output je null.

ArgumentException

output není zapisovatelný.

SaveLzipped(string, TarFormat?)

Uloží archiv do souboru podle cesty s lzip kompresí.

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

Parametry

path string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Uloží archiv do proudu s xz kompresí.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

settings XzArchiveSettings

Sada nastavení pro konkrétní xz archiv: velikost slovníku, velikost bloku, typ kontroly.

Příklady

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

Poznámky

output musí být zapisovatelný.

Výjimky

ArgumentNullException

output je null.

ArgumentException

output není zapisovatelný.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Uloží archiv na cestu podle cesty s xz kompresí.

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

Parametry

path string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

settings XzArchiveSettings

Sada nastavení pro konkrétní xz archiv: velikost slovníku, velikost bloku, typ kontroly.

Příklady

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

Uloží archiv do proudu s Z kompresí.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

output musí být zapisovatelný.

Výjimky

ArgumentNullException

output je null.

ArgumentException

output není zapisovatelný.

SaveZCompressed(string, TarFormat?)

Uloží archiv na cestu podle cesty s Z kompresí.

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

Parametry

path string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

SaveZstandard(Stream, TarFormat?)

Uloží archiv do proudu s Zstandard kompresí.

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

Parametry

output Stream

Cílový proud.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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

Poznámky

output musí být zapisovatelný.

Výjimky

ArgumentNullException

output je null.

ArgumentException

output není zapisovatelný.

SaveZstandard(string, TarFormat?)

Uloží archiv do souboru podle cesty se Zstandard kompresí.

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

Parametry

path string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

format TarFormat?

Definuje formát hlavičky tar. Null hodnota bude považována za USTar, když je to možné.

Příklady

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");
    }
}
 Čeština