Class TarArchive

Class TarArchive

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

Questa classe rappresenta un file di archivio tar. Usalo per comporre, estrarre o aggiornare archivi tar.

public class TarArchive : IArchive, IDisposable

Ereditarietà

objectTarArchive

Implementa

IArchive, IDisposable

Membri ereditati

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

Costruttori

TarArchive()

Inizializza una nuova istanza della classe Aspose.Zip.Tar.TarArchive.

public TarArchive()

Esempi

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 istanza della classe Aspose.Zip.Archive e compone un elenco di voci che possono essere estratte dall’archivio.

public TarArchive(Stream sourceStream)

Parametri

sourceStream Stream

La sorgente dell’archivio. Deve essere cercabile.

Esempi

Il seguente esempio mostra come estrarre tutte le voci in una directory.

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

Osservazioni

Questo costruttore non estrae alcuna voce. Vedi il metodo Aspose.Zip.Tar.TarEntry.Open per l’estrazione.

Eccezioni

InvalidDataException

sourceStream non è cercabile.

TarArchive(string)

Inizializza una nuova istanza della classe Aspose.Zip.Tar.TarArchive e compone un elenco di voci che possono essere estratte dall’archivio.

public TarArchive(string path)

Parametri

path string

Il percorso del file di archivio.

Esempi

Il seguente esempio mostra come estrarre tutte le voci in una directory.

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

Osservazioni

Questo costruttore non estrae alcuna voce. Vedi il metodo Aspose.Zip.Tar.TarEntry.Open per l’estrazione.

Eccezioni

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

Il path, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in path contiene un due punti (:) nel mezzo della stringa.

FileNotFoundException

Il file non è stato trovato.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.

IOException

Il file è già aperto.

Proprietà

Entries

Ottiene le voci di tipo Aspose.Zip.Tar.TarEntry che costituiscono l’archivio.

public ReadOnlyCollection<tarentry> Entries { get; }

Valore della Proprietà

ReadOnlyCollection<TarEntry&gt;

Metodi

CreateEntries(DirectoryInfo, bool)

Aggiunge all’archivio tutti i file e le directory ricorsivamente nella directory fornita.

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

Parametri

directory DirectoryInfo

Directory da comprimere.

includeRootDirectory bool

Indica se includere o meno la directory radice stessa.

Restituisce

TarArchive

L’archivio con le voci composte.

Esempi

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

CreateEntries(string, bool)

Aggiunge all’archivio tutti i file e le directory ricorsivamente nella directory fornita.

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

Parametri

sourceDirectory string

Directory da comprimere.

includeRootDirectory bool

Indica se includere o meno la directory radice stessa.

Restituisce

TarArchive

L’archivio con le voci composte.

Esempi

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

Eccezioni

ArgumentNullException

sourceDirectory è nullo.

SecurityException

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

ArgumentException

sourceDirectory contiene caratteri non validi come “, <, >, o |.

PathTooLongException

Il path, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri. Il path, il nome del file, o entrambi sono troppo lunghi.

CreateEntry(string, Stream, FileSystemInfo)

Crea una singola voce all’interno dell’archivio.

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

Parametri

name string

Il nome della voce.

source Stream

Il flusso di input per la voce.

fileInfo FileSystemInfo

I metadati del file o della cartella da comprimere.

Restituisce

TarEntry

Istanze di TarEntry.

Esempi

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

Osservazioni

Il nome della voce è impostato esclusivamente all'interno del parametro name. Il nome del file fornito nel parametro fileInfo non influisce sul nome della voce.

fileInfo può riferirsi a System.IO.DirectoryInfo se la voce è una directory.

Eccezioni

PathTooLongException

name è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.

ArgumentException

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

CreateEntry(string, FileInfo, bool)

Crea una singola voce all’interno dell’archivio.

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

Parametri

name string

Il nome della voce.

fileInfo FileInfo

I metadati del file o della cartella da comprimere.

openImmediately bool

Vero se aprire il file immediatamente, altrimenti aprire il file al salvataggio dell’archivio.

Restituisce

TarEntry

Istanze di TarEntry.

Esempi

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

Osservazioni

Il nome della voce è impostato esclusivamente all'interno del parametro name. Il nome del file fornito nel parametro fileInfo non influisce sul nome della voce.

fileInfo può riferirsi a System.IO.DirectoryInfo se la voce è una directory.

Se il file viene aperto immediatamente con il parametro openImmediately, diventa bloccato fino a quando l'archivio non viene eliminato.

Eccezioni

PathTooLongException

name è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.

ArgumentException

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

CreateEntry(string, string, bool)

Crea una singola voce all’interno dell’archivio.

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

Parametri

name string

Il nome della voce.

path string

Percorso del file da comprimere.

openImmediately bool

Vero se aprire il file immediatamente, altrimenti aprire il file al salvataggio dell’archivio.

Restituisce

TarEntry

Istanze di TarEntry.

Esempi

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

Osservazioni

Il nome della voce è impostato esclusivamente all'interno del parametro name. Il nome del file fornito nel parametro path non influisce sul nome della voce.

Se il file viene aperto immediatamente con il parametro openImmediately, diventa bloccato fino a quando l'archivio non viene eliminato.

Eccezioni

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi. - o - Il nome del file, come parte di name, supera i 100 simboli.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

Il path, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri. - o - name è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.

NotSupportedException

Il file in path contiene un due punti (:) nel mezzo della stringa.

DeleteEntry(TarEntry)

Rimuove la prima occorrenza di una voce specifica dall’elenco delle voci.

public TarArchive DeleteEntry(TarEntry entry)

Parametri

entry TarEntry

La voce da rimuovere dall’elenco delle voci.

Restituisce

TarArchive

L’archivio con la voce eliminata.

Esempi

Ecco come puoi rimuovere tutte le voci 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)

Rimuove la voce dall’elenco delle voci per indice.

public TarArchive DeleteEntry(int entryIndex)

Parametri

entryIndex int

L’indice basato su zero della voce da rimuovere.

Restituisce

TarArchive

L’archivio con la voce eliminata.

Esempi

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

Eccezioni

ArgumentOutOfRangeException

entryIndex è minore di 0.-o- entryIndex è uguale o maggiore del conteggio di Entries.

Dispose()

Esegue attività definite dall’applicazione associate al rilascio, alla liberazione o al ripristino delle risorse non gestite.

public void Dispose()

Dispose(bool)

Esegue attività definite dall’applicazione associate al rilascio, alla liberazione o al ripristino delle risorse non gestite.

protected virtual void Dispose(bool disposing)

Parametri

disposing bool

Se le risorse gestite devono essere eliminate.

ExtractToDirectory(string)

Estrae tutti i file nell’archivio nella directory fornita.

public void ExtractToDirectory(string destinationDirectory)

Parametri

destinationDirectory string

Il percorso della directory in cui posizionare i file estratti.

Esempi

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

Osservazioni

Se la directory non esiste, verrà creata.

Eccezioni

ArgumentNullException

path è nullo

PathTooLongException

Il path, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

SecurityException

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

NotSupportedException

Se la directory non esiste, il path contiene un carattere due punti (:) che non fa parte di un’etichetta di unità (“C:").

ArgumentException

path è una stringa di lunghezza zero, contiene solo spazi bianchi o contiene uno o più caratteri non validi. Puoi interrogare i caratteri non validi utilizzando il metodo System.IO.Path.GetInvalidPathChars. -o- path è prefissato con, o contiene, solo un carattere due punti (:).

IOException

La directory specificata dal path è un file. -o- Il nome della rete non è noto.

FromGZip(Stream)

Estrae l’archivio gzip fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio gzip viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromGZip(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

Il flusso di estrazione GZip non è cercabile per natura dell’algoritmo di compressione. L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

Eccezioni

InvalidDataException

L’archivio è corrotto.

FromGZip(string)

Estrae l’archivio gzip fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio gzip viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromGZip(string path)

Parametri

path string

Il percorso del file di archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

Il flusso di estrazione GZip non è cercabile per natura dell’algoritmo di compressione. L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

Eccezioni

InvalidDataException

L’archivio è corrotto.

FromLZMA(Stream)

Estrae l’archivio LZMA fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio LZMA viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromLZMA(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

Il flusso di estrazione LZMA non è cercabile per natura dell’algoritmo di compressione. L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromLZMA(string)

Estrae l’archivio LZMA fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio LZMA viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromLZMA(string path)

Parametri

path string

Il percorso del file di archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

Il flusso di estrazione LZMA non è cercabile per natura dell’algoritmo di compressione. L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromLZip(Stream)

Estrae l’archivio lzip fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio lzip viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromLZip(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

Il flusso di estrazione lzip non è cercabile per natura dell’algoritmo di compressione. L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromLZip(string)

Estrae l’archivio lzip fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio lzip viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromLZip(string path)

Parametri

path string

Il percorso del file di archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

Il flusso di estrazione lzip non è cercabile per natura dell’algoritmo di compressione. L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromXz(Stream)

Estrae l’archivio in formato xz fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio xz viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromXz(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromXz(string)

Estrae l’archivio in formato xz fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio xz viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromXz(string path)

Parametri

path string

Il percorso del file di archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromZ(Stream)

Estrae l’archivio in formato Z fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio Z viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromZ(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromZ(string)

Estrae l’archivio in formato Z fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio Z viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromZ(string path)

Parametri

path string

Il percorso del file di archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Osservazioni

L’archivio Tar fornisce la possibilità di estrarre un record arbitrario, quindi deve operare su un flusso cercabile sotto il cofano.

FromZstandard(Stream)

Estrae l’archivio Zstandard fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio Zstandard viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromZstandard(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Eccezioni

IOException

Il flusso Zstandard è corrotto o non leggibile.

InvalidDataException

I dati sono corrotti.

FromZstandard(string)

Estrae l’archivio Zstandard fornito e compone Aspose.Zip.Tar.TarArchive dai dati estratti.

Importante: l'archivio Zstandard viene completamente estratto all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

public static TarArchive FromZstandard(string path)

Parametri

path string

Il percorso del file di archivio.

Restituisce

TarArchive

Un’istanza di Aspose.Zip.Tar.TarArchive

Eccezioni

IOException

Il flusso Zstandard è corrotto o non leggibile.

InvalidDataException

I dati sono corrotti.

Save(Stream, TarFormat?)

Salva l’archivio nel flusso fornito.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

output deve essere scrivibile.

Eccezioni

ArgumentException

output non è scrivibile. - o - output è lo stesso flusso da cui estraiamo. - OPPURE - È impossibile salvare l’archivio nel format a causa di restrizioni sul formato.

Save(string, TarFormat?)

Salva l’archivio nel file di destinazione fornito.

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

Parametri

destinationFileName string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

È possibile salvare un archivio nello stesso percorso da cui è stato caricato. Tuttavia, questo non è raccomandato perché questo approccio utilizza la copia in un file temporaneo.

Eccezioni

ArgumentException

destinationFileName è una stringa di lunghezza zero, contiene solo spazi bianchi o contiene uno o più caratteri non validi come definiti da System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName è nullo.

PathTooLongException

Il destinationFileName, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

DirectoryNotFoundException

Il destinationFileName specificato non è valido, (ad esempio, si trova su un’unità non mappata).

IOException

Si è verificato un errore di I/O durante l’apertura del file.

UnauthorizedAccessException

destinationFileName specificava un file che è di sola lettura e l’accesso non è in lettura. -o- il percorso specificava una directory. -o- Il chiamante non ha il permesso richiesto.

NotSupportedException

destinationFileName è in un formato non valido.

FileNotFoundException

Il file non è stato trovato.

SaveGzipped(Stream, TarFormat?)

Salva l’archivio nel flusso con compressione gzip.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

output deve essere scrivibile.

Eccezioni

ArgumentNullException

output è nullo.

ArgumentException

output non è scrivibile.

SaveGzipped(string, TarFormat?)

Salva l’archivio nel file per percorso con compressione gzip.

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

Parametri

path string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

SaveLZMACompressed(Stream, TarFormat?)

Salva l’archivio nel flusso con compressione LZMA.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

output deve essere scrivibile.

Importante: l'archivio tar è composto e poi compresso all'interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

Eccezioni

ArgumentNullException

output è nullo.

ArgumentException

output non è scrivibile.

SaveLZMACompressed(string, TarFormat?)

Salva l’archivio nel file per percorso con compressione lzma.

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

Parametri

path string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

Importante: l’archivio tar è composto e poi compresso all’interno di questo metodo, il suo contenuto è mantenuto internamente. Fai attenzione al consumo di memoria.

SaveLzipped(Stream, TarFormat?)

Salva l’archivio nel flusso con compressione lzip.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

output deve essere scrivibile.

Eccezioni

ArgumentNullException

output è nullo.

ArgumentException

output non è scrivibile.

SaveLzipped(string, TarFormat?)

Salva l’archivio nel file per percorso con compressione lzip.

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

Parametri

path string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Salva l’archivio nel flusso con compressione xz.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

settings XzArchiveSettings

Insieme di impostazioni per l’archivio xz: dimensione del dizionario, dimensione del blocco, tipo di controllo.

Esempi

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

Osservazioni

output deve essere scrivibile.

Eccezioni

ArgumentNullException

output è nullo.

ArgumentException

output non è scrivibile.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Salva l’archivio nel percorso specificato con compressione xz.

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

Parametri

path string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

settings XzArchiveSettings

Insieme di impostazioni per l’archivio xz: dimensione del dizionario, dimensione del blocco, tipo di controllo.

Esempi

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

SaveZCompressed(Stream, TarFormat?)

Salva l’archivio nel flusso con compressione Z.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

output deve essere scrivibile.

Eccezioni

ArgumentNullException

output è nullo.

ArgumentException

output non è scrivibile.

SaveZCompressed(string, TarFormat?)

Salva l’archivio nel percorso specificato con compressione Z.

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

Parametri

path string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

SaveZstandard(Stream, TarFormat?)

Salva l’archivio nel flusso con compressione Zstandard.

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

Parametri

output Stream

Flusso di destinazione.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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

Osservazioni

output deve essere scrivibile.

Eccezioni

ArgumentNullException

output è nullo.

ArgumentException

output non è scrivibile.

SaveZstandard(string, TarFormat?)

Salva l’archivio nel file per percorso con compressione Zstandard.

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

Parametri

path string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

format TarFormat?

Definisce il formato dell’intestazione tar. Un valore nullo sarà trattato come USTar quando possibile.

Esempi

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