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
Implements
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
sourceStream’ is not seekable.
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
path’ is null.
Zákazník nemá požadované povolení k přístupu.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path’ obsahuje kolonu (:) uprostřed řádku.
Soubor nebyl nalezen.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
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
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
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
sourceDirectory’ is null.
Volající nemá požadované povolení k přístupu k sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
path’ is null.
Zákazník nemá požadované povolení k přístupu.
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.
Přístup k souboru path" je odmítnut.
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.
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
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 > 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
Archiv s vstupem byl vymazán.
Examples
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Exceptions
entryIndex’ is less than 0.-or-
entryIndex’ is equal to or greater than ‘Entries’ count.
Dispose()
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
Cesta je nulová
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.
Návštěvník nemá požadované povolení k přístupu k stávajícímu adresáři.
Pokud adresář neexistuje, trasa obsahuje znak kolonu (:) který není součástí označení disku (“C:”).
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 (:).
Řá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
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
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
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
path’ is null.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
Soubor nebyl nalezen.
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
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
path’ is null.
Zákazník nemá požadované povolení k přístupu
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
Soubor nebyl nalezen.
Soubor je příliš krátk.
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
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
Nelze číst z source’
source’ is null.
source’ is too short.
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
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
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
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
path’ is null.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
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
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
Archiv je zkorumpován.
source’ is not seekable.
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
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
path’ is null.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
Soubor nebyl nalezen.
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
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
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
path’ is null.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
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
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
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
path’ is null.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
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
Příklad aplikace Aspose.Zip.Tar.TarArchive
Exceptions
Zstandardní proud je zkorumpován nebo nelze číst.
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
Příklad aplikace Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.
Přístup k souboru path" je odmítnut.
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.
Soubor na path" je v neplatném formátu.
Uvedená trasa je neplatná, např. být na nezapsaném pohonu.
Soubor nebyl nalezen.
Zstandardní proud je zkorumpován nebo nelze číst.
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
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
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
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.
Uvedený destinationFileName’ je neplatný (např. je na nezapsaném disku).
Při otevření souboru došlo k chybě I/O.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
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
output’ is null.
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
Volající nemá požadované povolení. -or- path" specifikoval pouze přečtený soubor nebo adresář.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
Uvedený path" je neplatný (např. je na nezapsaném disku).
path’ is in an invalid format.