Class TarArchive

Class TarArchive

Numele spaţiului: Aspose.Zip.Tar Asamblare: Aspose.Zip.dll (25.5.0)

Această clasă reprezintă un fișier de arhivă tar. Utilizați-l pentru a compune, extrage sau actualizează arhivele Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Membrii moștenitori

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

Constructors

TarArchive()

Inițializează o nouă instanță a clasei Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

Următorul exemplu arată cum să compresezi un fișier.

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

TarArchive(Stream)

Inițializează o nouă instanță a clasei Aspose.Zip.Archive și compune o listă de intrări care poate fi extras din arhivă.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Sursă de arhivă. trebuie să fie căutată.

Examples

Următorul exemplu arată cum să extrageți toate intrările într-un director.

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

Remarks

Acest constructor nu dezambalează nici o intrare. Vezi Aspose.Zip.Tar.TarEntry.Metoda deschisă pentru dezambalare.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Strângere)

Inițializează o nouă instanță a clasei Aspose.Zip.TarArchive și compune o listă de intrări care poate fi extinsă din arhivă.

public TarArchive(string path)

Parameters

path string

Calea către arhivă.

Examples

Următorul exemplu arată cum să extrageți toate intrările într-un director.

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

Remarks

Acest constructor nu dezambalează nici o intrare. Vezi Aspose.Zip.Tar.TarEntry.Metoda deschisă pentru dezambalare.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Solicitantul nu are permisiunea necesară de acces.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

FileNotFoundException

Dosarul nu a fost găsit.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

IOException

Dosarul este deja deschis.

Properties

Entries

Obține intrări de tip Aspose.Zip.Tar.TarEntry care constituie arhiva.

public ReadOnlyCollection<tarentry> Entries { get; }

Valoarea proprietății

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(Cuvânt cheie, bool)

Adăugați în arhiv toate fișierele și directorii în mod recurent în directorul dat.

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

Parameters

directory DirectoryInfo

Directoare pentru compresă.

includeRootDirectory bool

Indică dacă să includă directorul de rădăcină în sine sau nu.

Returns

TarArchive

Arhiva cu intrări compuse.

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(Cuvânt cheie, bool)

Adăugați în arhiv toate fișierele și directorii în mod recurent în directorul dat.

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

Parameters

sourceDirectory string

Directoare pentru compresă.

includeRootDirectory bool

Indică dacă să includă directorul de rădăcină în sine sau nu.

Returns

TarArchive

Arhiva cu intrări compuse.

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

Solicitantul nu are permisiunea necesară pentru a accesa sourceDirectory'.

ArgumentException

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

PathTooLongException

Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere. Calea specificată, numele fișierului sau ambele sunt prea lungi.

CreateEntry(Strângere, Stream, FileSystemInfo)

Creați o singură intrare în arhivă.

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

Parameters

name string

Numele intrării.

source Stream

Rata de intrare pentru intrare.

fileInfo FileSystemInfo

Metadata fișierului sau a folderului trebuie să fie compresă.

Returns

TarEntry

Instanta de intrare.

Examples

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

Remarks

Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.

se poate face referire la System.IO.DirectoryInfo dacă intrarea este directorie.

Exceptions

PathTooLongException

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

ArgumentException

Numele fișierului, ca parte a name’, depășește 100 de simboluri.

CreateEntry(String, FileInfo și Bool)

Creați o singură intrare în arhivă.

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

Parameters

name string

Numele intrării.

fileInfo FileInfo

Metadata fișierului sau a folderului trebuie să fie compresă.

openImmediately bool

Adevărat, dacă deschideți imediat fișierul, în caz contrar deschideți fișierul pe stocarea arhivelor.

Returns

TarEntry

Instanta de intrare.

Examples

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

Remarks

Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.

se poate face referire la System.IO.DirectoryInfo dacă intrarea este directorie.

Dacă fișierul este deschis imediat cu parametru, acesta este blocat până când arhiva este eliminată.

Exceptions

PathTooLongException

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

ArgumentException

Numele fișierului, ca parte a name’, depășește 100 de simboluri.

CreateEntry(String, String și Bool)

Creați o singură intrare în arhivă.

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

Parameters

name string

Numele intrării.

path string

Calea pentru a fi compresat.

openImmediately bool

Adevărat, dacă deschideți imediat fișierul, în caz contrar deschideți fișierul pe stocarea arhivelor.

Returns

TarEntry

Instanta de intrare.

Examples

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

Remarks

Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.

Dacă fișierul este deschis imediat cu parametru, acesta este blocat până când arhiva este eliminată.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Solicitantul nu are permisiunea necesară de acces.

ArgumentException

path’ este gol, conține doar spații albe, sau conține caractere invalide. - sau - Numele fișierului, ca parte a name’, depășește 100 de simboluri.

UnauthorizedAccessException

Accesul la fișierul path” este refuzat.

PathTooLongException

De exemplu, pe platforme bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere. - sau - name’ este prea lung pentru tar decât standardul IEEE 1003.1-1998.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

DeleteEntry(TarEntry)

Elimină prima apariție a unei intrări specifice din lista de intrări.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Introducere pentru a elimina din lista de intrări.

Returns

TarArchive

Arhiva cu intrarea este ștersă.

Examples

Iată cum puteți șterge toate intrările, cu excepția celei din urmă:

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

DeleteEntry(int)

Îndepărtează intrarea din lista de intrare prin index.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Indicele de intrare bazat pe zero trebuie eliminat.

Returns

TarArchive

Arhiva cu intrarea este ștersă.

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

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

public void Dispose()

Dispose(Boulă)

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

În cazul în care resursele gestionate ar trebui să fie eliminate.

ExtractToDirectory(Strângere)

Extrage toate fișierele din arhivă în directorul furnizat.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Calea către directorie pentru a pune în fișierele extrase.

Examples

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

Remarks

Dacă directorul nu există, acesta va fi creat.

Exceptions

ArgumentNullException

Calea este zero

PathTooLongException

Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

SecurityException

Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.

NotSupportedException

Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă de disc (“C:”).

ArgumentException

Path este o linie de lungime zero, conține doar spațiu alb, sau conțin unul sau mai multe caractere invalide. puteți solicita pentru caracări invalid prin utilizarea metodei System.IO.Path.GetInvalidPithChars. - sau - traseul este prefixat cu sau contine, doar un caracter colon (:).

IOException

Directoriul specificat de cale este un fișier. - sau - Numele rețelei nu este cunoscut.

de la GZIP(Stream)

Extracte furnizate în arhiva gzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: archivul gzip este complet extras în această metodă, conținutul său este păstrat intern.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție GZip nu este căutat de natura algoritmului de compresie.Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

InvalidDataException

Arhiva este coruptă.

de la GZIP(Strângere)

Extracte furnizate în arhiva gzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: archivul gzip este complet extras în această metodă, conținutul său este păstrat intern.

public static TarArchive FromGZip(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție GZip nu este căutat de natura algoritmului de compresie.Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

InvalidDataException

Arhiva este coruptă.

de la LZ4(Strângere)

Extracte furnizate în arhiva LZ4 și compune Aspose.Zip.Tar.tarArchive din datele extrase.

Important: Arhiva LZ4 este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromLZ4(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție LZ4 nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrarea arbitrară, astfel încât trebuie să funcționeze un flux de căutare sub capcană.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Utilizatorul nu are permisiunea necesara de a accesa

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

EndOfStreamException

Fișierul este prea scurt.

InvalidDataException

Dosarul are semnătura greșită.

de la LZ4(Stream)

Extracte furnizate în arhiva LZ4 și compune Aspose.Zip.Tar.tarArchive din datele extrase.

Important: Arhiva LZ4 este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție LZ4 nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrarea arbitrară, astfel încât trebuie să funcționeze un flux de căutare sub capcană.

Exceptions

ArgumentException

Nu se poate citi din source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

Sursă " are semnătura greșită.

de la LZMA(Stream)

Extracte furnizate în arhiva LZMA și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: Arhiva LZMA este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție LZMA nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

InvalidDataException

Arhiva este coruptă.

de la LZMA(Strângere)

Extracte furnizate în arhiva LZMA și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: Arhiva LZMA este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromLZMA(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție LZMA nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrarea arbitrară, astfel încât trebuie să funcționeze un flux de căutare sub capcană.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

de la LZIP(Stream)

Extracte furnizate în arhiva lzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: archivul lzip este complet extras în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție Lzip nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

InvalidDataException

Arhiva este coruptă.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

de la LZIP(Strângere)

Extracte furnizate în arhiva lzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: archivul lzip este complet extras în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromLZip(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Fluxul de extracție Lzip nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

InvalidDataException

Arhiva este coruptă.

FromXz(Stream)

Extracte furnizate în arhiva formatului xz și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: archivul xz este complet extras în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

FromXz(Strângere)

Extracte furnizate în arhiva formatului xz și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: archivul xz este complet extras în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromXz(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

din Z(Stream)

Extracte furnizate Z format arhivă și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: Arhiva Z este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

din Z(Strângere)

Extracte furnizate Z format arhivă și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: Arhiva Z este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromZ(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Remarks

Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

FromZstandard(Stream)

Extracte furnizate în arhiva Zstandard și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: Arhiva standard este complet extrasă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Sursă a arhivelor.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Fluxul Zstandard este corupt sau nu poate fi citit.

InvalidDataException

Datele sunt corupte.

FromZstandard(Strângere)

Extracte furnizate în arhiva Zstandard și compune Aspose.Zip.Tar.TarArchive din datele extrase.

Important: Arhiva standard este complet extrasă în cadrul acestei metode, conținutul său este păstrat intern.

public static TarArchive FromZstandard(string path)

Parameters

path string

Calea către arhivă.

Returns

TarArchive

Un exemplu de Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path" este într-un format invalid.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

FileNotFoundException

Dosarul nu a fost găsit.

IOException

Fluxul Zstandard este corupt sau nu poate fi citit.

InvalidDataException

Datele sunt corupte.

Save(Războiul și TarFormat?)

Salvează arhiva la fluxul furnizat.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

Examples

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

Remarks

Trebuie să fie scrisă.

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(Războiul cu TarFormat?)

Salvează arhiva la un fișier de destinație furnizat.

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

Parameters

destinationFileName string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

Examples

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

Remarks

Este posibil să salvați un arhiv pe aceeași cale pe care a fost încărcat de la. Cu toate acestea, acest lucru nu este recomandat deoarece această abordare utilizează copierea la un fișier temporar.

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

De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

De exemplu, destinationFileName’ este invalidă (de exemplu, este pe un disc necartat).

IOException

A apărut o eroare I/O în timpul deschiderii fișierului.

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

Dosarul nu a fost găsit.

SaveGzipped(Războiul și TarFormat?)

Salvează arhivele în flux cu compresia gzip.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Trebuie să fie scrisă.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Războiul cu TarFormat?)

Salvează fișierul pe cale cu compresia gzip.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

Cuvânt cheie4Compressed(Războiul și TarFormat?)

Salvează arhivele în flux cu compresia LZ4.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Trebuie să fie scrisă.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Cuvânt cheie4Compressed(Războiul cu TarFormat?)

Salvează fișierul pe cale cu compresia LZ4.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

salvare compresă(Războiul și TarFormat?)

Salvează arhivele în flux cu compresia LZMA.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Trebuie să fie scrisă.

Important: arhiva tar este compusă apoi comprimată în cadrul acestei metode, conținutul său este păstrat intern.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

salvare compresă(Războiul cu TarFormat?)

Salvează fișierul pe cale cu compresia lzma.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Important: arhiva tar este compusă apoi comprimată în cadrul acestei metode, conținutul său este păstrat intern.

Exceptions

UnauthorizedAccessException

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Războiul și TarFormat?)

Salvează arhivele în flux cu compresia lzip.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Trebuie să fie scrisă.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Războiul cu TarFormat?)

Salvează fișierul pe cale cu compresia lzip.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Strămure, TarFormat?, XzArchiveSettings)

Salvează arhivele în flux cu compresia xz.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

settings XzArchiveSettings

Set de setare special xz arhiv: dimensiunea dicționarului, dimensiunea blocului, tipul de verificare.

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

Fluxul trebuie să fie scris.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(String, TarFormat?, XzArchiveSettings)

Salvează arhivele pe traseu prin traseu cu compresia xz.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

settings XzArchiveSettings

Set de setare special xz arhiv: dimensiunea dicționarului, dimensiunea blocului, tipul de verificare.

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

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

salvare compresă(Războiul și TarFormat?)

Salvează arhivele în flux cu compresia Z.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Trebuie să fie scrisă.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

salvare compresă(Războiul cu TarFormat?)

Salvează arhivele pe cale prin cale cu compresia Z.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Războiul și TarFormat?)

Salvează arhivele în flux cu compresia Zstandard.

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

Parameters

output Stream

Războiul de destinaţie.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Trebuie să fie scrisă.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Războiul cu TarFormat?)

Salvează fișierul pe cale cu compresia Zstandard.

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

Parameters

path string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

format TarFormat ?

Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.

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

Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.

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

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

DirectoryNotFoundException

Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).

NotSupportedException

path’ is in an invalid format.

 Română