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à
Implementa
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
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
path
è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path
è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path
negato.
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 file in path
contiene un due punti (:) nel mezzo della stringa.
Il file non è stato trovato.
Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.
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>
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
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
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
sourceDirectory
è nullo.
Il chiamante non ha il permesso richiesto per accedere a sourceDirectory
.
sourceDirectory
contiene caratteri non validi come “, <, >, o |.
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
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
name
è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.
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
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
name
è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.
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
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
path
è nullo.
Il chiamante non ha il permesso richiesto per accedere.
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.
Accesso al file path
negato.
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.
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
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 > 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
L’archivio con la voce eliminata.
Esempi
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Eccezioni
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
path è nullo
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 chiamante non ha il permesso richiesto per accedere alla directory esistente.
Se la directory non esiste, il path contiene un carattere due punti (:) che non fa parte di un’etichetta di unità (“C:").
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 (:).
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
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
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
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
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
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
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
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
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
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
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
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
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
Un’istanza di Aspose.Zip.Tar.TarArchive
Eccezioni
Il flusso Zstandard è corrotto o non leggibile.
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
Un’istanza di Aspose.Zip.Tar.TarArchive
Eccezioni
Il flusso Zstandard è corrotto o non leggibile.
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
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
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.
destinationFileName
è nullo.
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.
Il destinationFileName
specificato non è valido, (ad esempio, si trova su un’unità non mappata).
Si è verificato un errore di I/O durante l’apertura del file.
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.
destinationFileName
è in un formato non valido.
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
output
è nullo.
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.
Eccezioni
output
è nullo.
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
output
è nullo.
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
output
è nullo.
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
output
è nullo.
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
output
è nullo.
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");
}
}