Class TarArchive

Class TarArchive

Le nom : Aspose.Zip.Tar Assemblée: Aspose.Zip.dll (25.5.0)

Cette classe représente un fichier d’archivage tar. Utilisez-le pour composer, extraire ou mettre à jour les archives Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

I membri ereditari

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

Constructors

TarArchive()

Inizia una nuova instanza della classe Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

Il seguente esempio mostra come comprimere un file.

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

TarArchive(Stream)

Inizializza una nuova instanza della classe Aspose.Zip.Archivio e compone un elenco di entrate che può essere estratto dall’archivio.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

La fonte dell’archivio. deve essere ricercabile.

Examples

L’esempio seguente mostra come estrarre tutte le entrate in un directory.

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

Remarks

Questo costruttore non spazzatura nessun ingresso. vedi Aspose.Zip.Tar.TarEntry.Open metodo per spazzatura.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Le string)

Initialisez une nouvelle instance de la classe Aspose.Zip.Tar.tarArchive et compose une liste d’entrée qui peut être extraite de l’archive.

public TarArchive(string path)

Parameters

path string

Il percorso verso l’archivio.

Examples

L’esempio seguente mostra come estrarre tutte le entrate in un directory.

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

Remarks

Questo costruttore non spazzatura nessun ingresso. vedi Aspose.Zip.Tar.TarEntry.Open metodo per spazzatura.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

Il file è già aperto.

Properties

Entries

Riceve le entrate del tipo Aspose.Zip.Tar.TarEntry che costituisce l’archivio.

public ReadOnlyCollection<tarentry> Entries { get; }

Valore di proprietà

ReadOnlyCollection di < TarEntry >

Methods

CreateEntries(Résumé : Bool)

Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.

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

Parameters

directory DirectoryInfo

Direttore per la compressione.

includeRootDirectory bool

Indica se includere lo stesso directory root o meno.

Returns

TarArchive

L’archivio con entrate composte.

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(Télécharger, Bool)

Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.

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

Parameters

sourceDirectory string

Direttore per la compressione.

includeRootDirectory bool

Indica se includere lo stesso directory root o meno.

Returns

TarArchive

L’archivio con entrate composte.

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

Il chiamante non ha il permesso richiesto per accedere a sourceDirectory'.

ArgumentException

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

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

CreateEntry(Télécharger, Stream, FileSystemInfo)

Creare un singolo ingresso all’interno dell’archivio.

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

Parameters

name string

Il nome dell’ingresso.

source Stream

Il flusso di ingresso per l’ingresso.

fileInfo FileSystemInfo

I metadati del file o della cartella da comprimere.

Returns

TarEntry

L’istanza di ingresso.

Examples

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

Remarks

Le nom de fichier fourni dans le paramètre n’affecte pas le nom de fichier.

Vous pouvez vous référer à System.IO.DirectoryInfo si l’entrée est la directory.

Exceptions

PathTooLongException

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

ArgumentException

Il nome del file, come parte di name’, supera i 100 simboli.

CreateEntry(Téléchargement, FileInfo, Bool)

Creare un singolo ingresso all’interno dell’archivio.

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

Parameters

name string

Il nome dell’ingresso.

fileInfo FileInfo

I metadati del file o della cartella da comprimere.

openImmediately bool

È vero, se si apre immediatamente il file, altrimenti si apre il file su archivio di archiviazione.

Returns

TarEntry

L’istanza di ingresso.

Examples

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

Remarks

Le nom de fichier fourni dans le paramètre n’affecte pas le nom de fichier.

Vous pouvez vous référer à System.IO.DirectoryInfo si l’entrée est la directory.

Si le fichier est ouvert immédiatement avec le paramètre, il est bloqué jusqu’à ce que l’archive soit éliminée.

Exceptions

PathTooLongException

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

ArgumentException

Il nome del file, come parte di name’, supera i 100 simboli.

CreateEntry(String, String et Bool)

Creare un singolo ingresso all’interno dell’archivio.

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

Parameters

name string

Il nome dell’ingresso.

path string

Il modo in cui il file viene compreso.

openImmediately bool

È vero, se si apre immediatamente il file, altrimenti si apre il file su archivio di archiviazione.

Returns

TarEntry

L’istanza di ingresso.

Examples

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

Remarks

Le nom de fichier fourni dans le paramètre n’affecte pas le nom de fichier.

Si le fichier est ouvert immédiatement avec le paramètre, il est bloqué jusqu’à ce que l’archive soit éliminée.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

Il path’ è vuoto, contiene solo spazi bianchi, o contiene caratteri invalidi. - o - Nome del file, come parte del name’, supera i 100 simboli.

UnauthorizedAccessException

L’accesso al file path” è rifiutato.

PathTooLongException

Per esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi dei file devono essere meno di 260 caratteri. - o - name’ è troppo lungo per tar rispetto allo standard IEEE 1003.1-1998.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

DeleteEntry(TarEntry)

Rimuove la prima comparsa di un’entrata specifica dall’elenco delle entrate.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

L’ingresso da rimuovere dall’elenco delle entrate.

Returns

TarArchive

L’archivio con l’ingresso è stato cancellato.

Examples

Ecco come puoi rimuovere tutte le entrate tranne l’ultima:

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

DeleteEntry(int)

Rimuovere l’ingresso dalla lista di ingressi per indice.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

L’indice basato su zero dell’ingresso da rimuovere.

Returns

TarArchive

L’archivio con l’ingresso è stato cancellato.

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

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

public void Dispose()

Dispose(Boulée)

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Le risorse gestite dovrebbero essere sprecate.

ExtractToDirectory(Le string)

Estratta tutti i file nell’archivio nel directory fornito.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Il percorso verso il directory per posizionare i file estratti.

Examples

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

Remarks

Se il directory non esiste, sarà creato.

Exceptions

ArgumentNullException

Il percorso è zero

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

SecurityException

Il chiamante non ha il permesso richiesto per accedere al directory esistente.

NotSupportedException

Si le catalogue n’existe pas, la voie contient un caractère colon (:) qui n’est pas partie d’une étiquette de disque (“C:”).

ArgumentException

Path est une ligne de longueur zéro, ne contient que de l’espace blanc, ou contiennent un ou plusieurs caractères invalides. Vous pouvez demander pour des caractère invalide en utilisant la méthode System.IO.Path.GetInvalidPithChars. - ou - le chemin est préfixé avec, et/ou ne contenait, seulement un personnage colon (:).

IOException

Le catalogue spécifié par voie est un fichier. - ou - Le nom de réseau n’est pas connu.

à GZIP(Stream)

Gli estratti forniti archivio gzip e composte Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : l’archive gzip est entièrement extraite dans cette méthode, son contenu est conservé internellement.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Il flusso di estrazione GZip non è richiesto dalla natura dell’algoritmo di compressione.L’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi ha bisogno di operare il flusso richiesto sotto il cappello.

Exceptions

InvalidDataException

L’archivio è corrotto.

à GZIP(Le string)

Gli estratti forniti archivio gzip e composte Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : l’archive gzip est entièrement extraite dans cette méthode, son contenu est conservé internellement.

public static TarArchive FromGZip(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Il flusso di estrazione GZip non è richiesto dalla natura dell’algoritmo di compressione.L’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi ha bisogno di operare il flusso richiesto sotto il cappello.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

InvalidDataException

L’archivio è corrotto.

de LZ4(Le string)

Extracts fournis LZ4 archive et compose Aspose.Zip.Tar.Archive des données extraites.

Important : LZ4 archive est entièrement extrait dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromLZ4(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Le flux d’extraction LZ4 n’est pas recherchable par la nature de l’algorithme de compression.L’archive Tar fournit une facilité pour extraire des enregistrements arbitraires, de sorte qu’il doit opérer le courant recherché sous le coude.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il richiedente non ha il permesso di accesso richiesto

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

EndOfStreamException

Il file è troppo breve.

InvalidDataException

Le fichier a la mauvaise signature.

de LZ4(Stream)

Extracts fournis LZ4 archive et compose Aspose.Zip.Tar.Archive des données extraites.

Important : LZ4 archive est entièrement extrait dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Le flux d’extraction LZ4 n’est pas recherchable par la nature de l’algorithme de compression.L’archive Tar fournit une facilité pour extraire des enregistrements arbitraires, de sorte qu’il doit opérer le courant recherché sous le coude.

Exceptions

ArgumentException

On ne peut pas lire de source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

La source > a la signature erronée.

de LZMA(Stream)

Gli estratti forniti all’archivio LZMA e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : LZMA archive est entièrement extrait dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Il flusso di estrazione LZMA non è ricercabile per la natura dell’algoritmo di compressione. l’archivio Tar fornisce facilità per estrarre il record arbitrario, quindi deve operare il flusso ricercabile sotto il cappello.

Exceptions

InvalidDataException

L’archivio è corrotto.

de LZMA(Le string)

Gli estratti forniti all’archivio LZMA e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : LZMA archive est entièrement extrait dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromLZMA(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Le flux d’extraction LZMA n’est pas recherchable par la nature de l’algorithme de compression.L’archive Tar fournit une facilité pour extraire des enregistrements arbitraires, de sorte qu’il doit opérer le courant recherché sous le coude.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

par ZIP(Stream)

Gli estratti forniti lzip archivio e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : lzip archive est entièrement extrait dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Il flusso di estrazione Lzip non è ricercabile per la natura dell’algoritmo di compressione. l’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi deve operare il flusso ricercabile sotto il cappello.

Exceptions

InvalidDataException

L’archivio è corrotto.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

par ZIP(Le string)

Gli estratti forniti lzip archivio e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : lzip archive est entièrement extrait dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromLZip(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

Il flusso di estrazione Lzip non è ricercabile per la natura dell’algoritmo di compressione. l’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi deve operare il flusso ricercabile sotto il cappello.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

InvalidDataException

L’archivio è corrotto.

FromXz(Stream)

Gli estratti forniti all’archivio del formato xz e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : l’archive xz est complètement extraite dans cette méthode, son contenu est conservé internellement.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

L’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi ha bisogno di operare il flusso richiesto sotto il cappello.

FromXz(Le string)

Gli estratti forniti all’archivio del formato xz e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : l’archive xz est complètement extraite dans cette méthode, son contenu est conservé internellement.

public static TarArchive FromXz(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

L’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi ha bisogno di operare il flusso richiesto sotto il cappello.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

de Z(Stream)

Gli estratti forniscono archivio di formato Z e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : L’archive Z est entièrement extraite dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

L’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi ha bisogno di operare il flusso richiesto sotto il cappello.

de Z(Le string)

Gli estratti forniscono archivio di formato Z e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : L’archive Z est entièrement extraite dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromZ(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Remarks

L’archivio Tar fornisce la facilità di estrarre il record arbitrario, quindi ha bisogno di operare il flusso richiesto sotto il cappello.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

FromZstandard(Stream)

Gli estratti forniti dall’archivio Zstandard e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : L’archive standard est entièrement extraite dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Il flusso Zstandard è corrotto o non leggibile.

InvalidDataException

I dati sono corrotti.

FromZstandard(Le string)

Gli estratti forniti dall’archivio Zstandard e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.

Important : L’archive standard est entièrement extraite dans cette méthode, son contenu est conservé à l’intérieur.

public static TarArchive FromZstandard(string path)

Parameters

path string

Il percorso verso l’archivio.

Returns

TarArchive

Un esempio di Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Le fichier à path’ est dans un format invalide.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

FileNotFoundException

Il file non è trovato.

IOException

Il flusso Zstandard è corrotto o non leggibile.

InvalidDataException

I dati sono corrotti.

Save(Téléchargement ou Tarformat ?)

Salva archivio al flusso fornito.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

Examples

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

Remarks

doit être écrite.

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(Télécharger, Télécharger ?)

Salva archivio a un file di destinazione fornito.

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

Parameters

destinationFileName string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

Examples

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

Remarks

È possibile salvare un archivio nello stesso percorso dal quale è stato caricato. tuttavia, questo non è raccomandato perché questo approccio utilizza la copia a un file temporaneo.

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

La specifica destinationFileName’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La specifica destinationFileName’ è invalida (ad esempio, si trova su un disco non mappato).

IOException

Un errore I/O si è verificato durante l’apertura del file.

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

Il file non è trovato.

SaveGzipped(Téléchargement ou Tarformat ?)

Salva archivi al flusso con la compressione gzip.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Télécharger, Télécharger ?)

Salva l’archivio al file per via con la compressione gzip.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

SaveLZ4Comprimé(Téléchargement ou Tarformat ?)

Économisez les archives dans le courant avec la compression LZ4.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4Comprimé(Télécharger, Télécharger ?)

Économisez l’archive dans le fichier par voie avec la compression LZ4.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

Réservation compresse(Téléchargement ou Tarformat ?)

Salva archivio al flusso con la compressione LZMA.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

doit être écrite.

Importante: l’archivio tar viene compostato e quindi compreso all’interno di questo metodo, il suo contenuto viene conservato internamente.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Réservation compresse(Télécharger, Télécharger ?)

Salva archivio al file per via con lzma compressione.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

Importante: l’archivio tar viene compostato e quindi compreso all’interno di questo metodo, il suo contenuto viene conservato internamente.

Exceptions

UnauthorizedAccessException

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Téléchargement ou Tarformat ?)

Salva archivi al flusso con la compressione lzip.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Télécharger, Télécharger ?)

Salva l’archivio al file per via con la compressione lzip.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Téléchargement, Téléchargement, XzArchiveSettings)

Salva archivio al flusso con la compressione xz.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

settings XzArchiveSettings

Set di impostazioni specifici xz archivio: dimensione del dizionario, dimensione del blocco, tipo di controllo.

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

Le flux doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Téléchargement, Téléchargement, XzArchiveSettings)

Salva l’archivio per strada con la compressione xz.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

settings XzArchiveSettings

Set di impostazioni specifici xz archivio: dimensione del dizionario, dimensione del blocco, tipo di controllo.

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

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

RésuméComprimé(Téléchargement ou Tarformat ?)

Salva archivio al flusso con la compressione Z.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

RésuméComprimé(Télécharger, Télécharger ?)

Salva l’archivio per strada con la compressione Z.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Téléchargement ou Tarformat ?)

Salva archivio al flusso con la compressione Zstandard.

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

Parameters

output Stream

Il flusso di destinazione.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

doit être écrite.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Télécharger, Télécharger ?)

Salva l’archivio al file per strada con la compressione standard.

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

Parameters

path string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

format TarFormat ?

Definisce il formato del titolo tar. Il valore zero sarà trattato come USTar quando possibile.

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

L’appelant n’a pas l’autorisation requise. -or- path’ spécifié un fichier ou un catalogue à lire uniquement.

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

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

DirectoryNotFoundException

La voie " spécifiée est invalide (par exemple, elle est sur un disque non mappé).

NotSupportedException

path’ is in an invalid format.

 Français