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í
Implementuje
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
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
path
je null.
Volající nemá potřebné oprávnění k přístupu.
path
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru path
je odepřen.
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ů.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.
Soubor nebyl nalezen.
Zadaná cesta je neplatná, například se nachází na nepřiřazeném disku.
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>
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í
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í
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
sourceDirectory
je null.
Volající nemá potřebné oprávnění k přístupu sourceDirectory
.
sourceDirectory
obsahuje neplatné znaky, jako jsou “, <, > nebo |.
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í
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
name
je příliš dlouhé pro tar podle standardu IEEE 1003.1-1998.
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í
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
name
je příliš dlouhé pro tar podle standardu IEEE 1003.1-1998.
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í
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
path
je null.
Volající nemá potřebné oprávnění k přístupu.
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ů.
Přístup k souboru path
je odepřen.
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.
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í
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 > 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í
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
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
cesta je null.
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ů.
Volající nemá potřebné oprávnění k přístupu k existujícímu adresáři.
Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí označení disku (“C:").
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 (:).
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í
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
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í
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
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í
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í
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í
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í
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í
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í
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í
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í
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í
Instance Aspose.Zip.Tar.TarArchive
Výjimky
Zstandard proud je poškozený nebo nečitelný.
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í
Instance Aspose.Zip.Tar.TarArchive
Výjimky
Zstandard proud je poškozený nebo nečitelný.
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
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
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.
destinationFileName
je null.
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ů.
Zadaná destinationFileName
je neplatná, (například se nachází na nepřiřazeném disku).
Došlo k chybě I/O při otevírání souboru.
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í.
destinationFileName
je v neplatném formátu.
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
output
je null.
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ý.
Výjimky
output
je null.
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
output
je null.
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
output
je null.
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
output
je null.
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
output
je null.
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");
}
}