Class TarArchive
Il nome: Aspose.Zip.Tar Assemblea: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta un file di archivio tar. Utilizzarlo per compilare, estrarre o aggiornare archivi Tar.
public class TarArchive : IArchive, IDisposableInheritance
Implements
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
sourceStream’ is not seekable.
sourceStream’ is null.
TarArchive(String)
Inizia una nuova instanza della classe Aspose.Zip.Tar.tarArchive e compone un elenco di entrate che può essere estratto dall’archivio.
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
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
Il file non è trovato.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
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(Sito ufficiale, 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
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(String e 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
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
sourceDirectory’ is null.
Il chiamante non ha il permesso richiesto per accedere a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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(String, Stream e 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
L’istanza di ingresso.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}Remarks
Il nome di ingresso è impostato esclusivamente all’interno del parametro.Il nome del file fornito nel parametro non influisce sul nome di ingresso.
può riferirsi a System.IO.DirectoryInfo se l’ingresso è directory.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Il nome del file, come parte di name’, supera i 100 simboli.
CreateEntry(String, FileInfo e 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
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
Il nome di ingresso è impostato esclusivamente all’interno del parametro.Il nome del file fornito nel parametro non influisce sul nome di ingresso.
può riferirsi a System.IO.DirectoryInfo se l’ingresso è directory.
Se il file viene aperto immediatamente con il parametro viene bloccato fino a quando l’archivio è disattivato.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Il nome del file, come parte di name’, supera i 100 simboli.
CreateEntry(String, String e 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
L’istanza di ingresso.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}Remarks
Il nome di ingresso è impostato esclusivamente all’interno del parametro.Il nome del file fornito nel parametro non influisce sul nome di ingresso.
Se il file viene aperto immediatamente con il parametro viene bloccato fino a quando l’archivio è disattivato.
Exceptions
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
Il path’ è vuoto, contiene solo spazi bianchi, o contiene caratteri invalidi. - o - Nome del file, come parte del name’, supera i 100 simboli.
L’accesso al file path” è rifiutato.
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.
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
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 > 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
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
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(di bool)
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(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
Il percorso è zero
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.
Il chiamante non ha il permesso richiesto per accedere al directory esistente.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“C:”).
Il percorso è una riga di lunghezza zero, contiene solo spazio bianco, o contengono uno o più caratteri invalidi. Puoi chiedere per i carati invaliditi utilizzando il metodo System.IO.Path.GetInvalid PathChars. - o - la strada è prefiammata con, oppure contenga, solo un personaggio colonico (:).
Il directory specificato per percorso è un file. - o - Il nome della rete non è noto.
di GZIP(Stream)
Gli estratti forniti archivio gzip e composte Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: l’archivio gzip è completamente estratto all’interno di questo metodo, il suo contenuto viene conservato internamente.
public static TarArchive FromGZip(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
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
L’archivio è corrotto.
di GZIP(String)
Gli estratti forniti archivio gzip e composte Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: l’archivio gzip è completamente estratto all’interno di questo metodo, il suo contenuto viene conservato internamente.
public static TarArchive FromGZip(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
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
path’ is null.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
L’archivio è corrotto.
di LZ4(String)
Gli estratti forniti LZ4 archivio e composte Aspose.Zip.Tar.tarArchive dai dati estratti.
Importante: LZ4 archivio è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromLZ4(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
Un esempio di Aspose.Zip.Tar.TarArchive
Remarks
Il flusso di estrazione LZ4 non è ricercabile per la natura dell’algoritmo di compressione. l’archivio Tar fornisce facilità per estrarre il record arbitrario, quindi ha bisogno di operare il fluso ricercatore sotto il cappello.
Exceptions
path’ is null.
Il richiedente non ha il permesso di accesso richiesto
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
Il file è troppo breve.
Il file ha la firma sbagliata.
di LZ4(Stream)
Gli estratti forniti LZ4 archivio e composte Aspose.Zip.Tar.tarArchive dai dati estratti.
Importante: LZ4 archivio è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromLZ4(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
Un esempio di Aspose.Zip.Tar.TarArchive
Remarks
Il flusso di estrazione LZ4 non è ricercabile per la natura dell’algoritmo di compressione. l’archivio Tar fornisce facilità per estrarre il record arbitrario, quindi ha bisogno di operare il fluso ricercatore sotto il cappello.
Exceptions
Non si può leggere da source’
source’ is null.
source’ is too short.
La source’ ha la firma sbagliata.
di LZMA(Stream)
Gli estratti forniti all’archivio LZMA e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: LZMA archivio è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromLZMA(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
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
L’archivio è corrotto.
di LZMA(String)
Gli estratti forniti all’archivio LZMA e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: LZMA archivio è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromLZMA(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
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 ha bisogno di operare il fluso ricercatore sotto il cappello.
Exceptions
path’ is null.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
di LZIP(Stream)
Gli estratti forniti lzip archivio e compone Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: lzip archivio è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromLZip(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
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
L’archivio è corrotto.
source’ is not seekable.
source’ is null.
di LZIP(String)
Gli estratti forniti lzip archivio e compone Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: lzip archivio è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromLZip(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
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
path’ is null.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
L’archivio è corrotto.
FromXz(Stream)
Gli estratti forniti all’archivio del formato xz e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: l’archivio xz è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromXz(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
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(String)
Gli estratti forniti all’archivio del formato xz e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: l’archivio xz è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromXz(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
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
path’ is null.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
da Z(Stream)
Gli estratti forniscono archivio di formato Z e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: L’archivio Z è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromZ(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
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.
da Z(String)
Gli estratti forniscono archivio di formato Z e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: L’archivio Z è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromZ(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
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
path’ is null.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
FromZstandard(Stream)
Gli estratti forniti dall’archivio Zstandard e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: L’archivio standard è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromZstandard(Stream source)Parameters
source Stream
La fonte dell’archivio.
Returns
Un esempio di Aspose.Zip.Tar.TarArchive
Exceptions
Il flusso Zstandard è corrotto o non leggibile.
I dati sono corrotti.
FromZstandard(String)
Gli estratti forniti dall’archivio Zstandard e compongono Aspose.Zip.Tar.TarArchive dai dati estratti.
Importante: L’archivio standard è completamente estratto all’interno di questo metodo, il suo contenuto è conservato internamente.
public static TarArchive FromZstandard(string path)Parameters
path string
Il percorso verso l’archivio.
Returns
Un esempio di Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path" è in formato invalido.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file non è trovato.
Il flusso Zstandard è corrotto o non leggibile.
I dati sono corrotti.
Save(Il flusso, il flusso?)
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
Deve essere scritta.
Exceptions
output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.
Save(String e TarFormat?)
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
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
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.
La specifica destinationFileName’ è invalida (ad esempio, si trova su un disco non mappato).
Un errore I/O si è verificato durante l’apertura del file.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
Il file non è trovato.
SaveGzipped(Il flusso, il flusso?)
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
Deve essere scritta.
Exceptions
output’ is null.
output’ is not writable.
SaveGzipped(String e TarFormat?)
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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
Salvatore 4 compreso(Il flusso, il flusso?)
Salva archivio al flusso con la compressione 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
Deve essere scritta.
Exceptions
output’ is null.
output’ is not writable.
Salvatore 4 compreso(String e TarFormat?)
Salva l’archivio al file per via con la compressione 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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
Salvataggio compreso(Il flusso, il flusso?)
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
Deve essere scritta.
Importante: l’archivio tar viene compostato e quindi compreso all’interno di questo metodo, il suo contenuto viene conservato internamente.
Exceptions
output’ is null.
output’ is not writable.
Salvataggio compreso(String e TarFormat?)
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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
SaveLzipped(Il flusso, il flusso?)
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
Deve essere scritta.
Exceptions
output’ is null.
output’ is not writable.
SaveLzipped(String e TarFormat?)
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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
SaveXzCompressed(Stream, TarFormat?, 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
Il flusso deve essere scritto.
Exceptions
output’ is null.
output’ is not writable.
SaveXzCompressed(String, TarFormat?, 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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
Salvataggio compreso(Il flusso, il flusso?)
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
Deve essere scritta.
Exceptions
output’ is null.
output’ is not writable.
Salvataggio compreso(String e TarFormat?)
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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
SaveZstandard(Il flusso, il flusso?)
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
Deve essere scritta.
Exceptions
output’ is null.
output’ is not writable.
SaveZstandard(String e TarFormat?)
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
Il chiamante non ha il permesso richiesto. -o- path’ specifica un file o directory leggendo solo.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La path" specificata è invalida (ad esempio, si trova su un disco non mappato).
path’ is in an invalid format.
