Class GzipArchive
Le nom : Aspose.Zip.Gzip Assemblée: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta un file di archivio gzip. Usalo per compilare o estrarre archivi gzip.
public class GzipArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
L’algoritmo di compressione Gzip si basa sull’algoritmo DEFLATE, che è una combinazione di codifica LZ77 e Huffman.
Constructors
GzipArchive()
Inizia una nuova instanza della classe Aspose.Zip.Gzip.GzipArchive preparata per la compressione.
public GzipArchive()Examples
L’exemple ci-dessous montre comment comprimer un fichier.
using (GzipArchive archive = new GzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.gz");
}GzipArchive(Le courant, le boul)
Inizia una nuova instanza della classe Aspose.Zip.Gzip.GzipArchive preparata per la decompressione.
public GzipArchive(Stream sourceStream, bool parseHeader = false)Parameters
sourceStream Stream
La fonte dell’archivio.
parseHeader bool
Che parsi il titolo di flusso per scoprire le proprietà, tra cui il nome. fa senso per il flusso solo ricercabile.
Examples
Ouvrez un fichier à partir d’un flux et extraissez-le à un
var ms = new MemoryStream();
using (GzipArchive archive = new GzipArchive(File.OpenRead("archive.gz")))
archive.Open().CopyTo(ms);Remarks
Questo costruttore non decomprime. vedi Aspose.Zip.Gzip.GzipArchive.Open metodo di decompressione.
Exceptions
sourceStream’ is null.
sourceStream’ is too short.
La sourceStream’ ha una firma sbagliata.
GzipArchive(Télécharger, Bool)
Inizia una nuova instanza della classe Aspose.Zip.Gzip.GzipArchive.
public GzipArchive(string path, bool parseHeader = false)Parameters
path string
Il percorso verso l’archivio.
parseHeader bool
Che parsi il titolo di flusso per scoprire le proprietà, tra cui il nome. fa senso per il flusso solo ricercabile.
Examples
Ouvrir un fichier par voie et l’extraire à un
var ms = new MemoryStream();
using (GzipArchive archive = new GzipArchive("archive.gz"))
archive.Open().CopyTo(ms);Remarks
Questo costruttore non decomprime. vedi Aspose.Zip.Gzip.GzipArchive.Open metodo di decompressione.
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 è troppo breve.
I dati nel file hanno una firma sbagliata.
Properties
Name
Nome di un file originale.
public string Name { get; }Valore di proprietà
UncompressedSize
Riceve la dimensione di un file originale.
public ulong UncompressedSize { get; }Valore di proprietà
Remarks
Durante la decompressione, questa proprietà può contenere dimensioni sbagliate.Se la dimensione del file non compreso supera 4GB, questa proprietà darà un valore sbagliato a causa del limite di 32 bit nel titolo.
Methods
Dispose()
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
public void Dispose()Dispose(Boulée)
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Le risorse gestite dovrebbero essere sprecate.
Extract(Stream)
L’archivio viene estratto nel flusso fornito.
public void Extract(Stream destination)Parameters
destination Stream
Destinazione Stream. deve essere scritta.
Examples
using (var archive = new GzipArchive("archive.gz"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Il flusso è corrotto e non contiene dati validi.
Extract(Le string)
L’archivio viene estratto nel file per via.
public FileInfo Extract(string path)Parameters
path string
Il percorso verso il file di destinazione. se il file esiste già, sarà sovrappeso.
Returns
Informazioni sul file estratto.
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 flusso è corrotto e non contiene dati validi.
ExtractToDirectory(Le string)
Eliminare il contenuto dell’archivio nella directory fornita.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Il percorso verso il directory per posizionare i file estratti.
Remarks
Se il directory non esiste, sarà creato.
Exceptions
destinationDirectory’ is null.
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.
Si le catalogue n’existe pas, la voie contient un caractère colon (:) qui n’est pas partie d’une étiquette de disque (“C:”).
destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).
Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.
Open()
Apri l’archivio per l’estrazione e fornisce un flusso con contenuti archivi.
public Stream Open()Returns
Il flusso che rappresenta il contenuto dell’archivio.
Examples
Elimina l’archivio e copia il contenuto estratto al file stream.
using (var archive = new GzipArchive("archive.gz"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}Vous pouvez utiliser la méthode Stream.CopyTo pour .NET 4.0 et supérieur : unpacked.Kopy To(extraits);
Remarks
Leggi dal flusso per ottenere il contenuto originale di un file.
Save(Stream)
Salva archivio al flusso fornito.
public void Save(Stream outputStream)Parameters
outputStream Stream
Il flusso di destinazione.
Examples
Scrivere i dati compressi al flusso di risposta http.
using (var archive = new GzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
doit être écrite.
Exceptions
outputStream’ is not writable.
La fonte non è stata fornita.
Save(Le string)
Salva l’archivio al file di destinazione fornito.
public void Save(string destinationFileName)Parameters
destinationFileName string
Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.
Examples
using (var archive = new GzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.gz");
}Exceptions
destinationFileName’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La destinationFileName’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file destinationFileName’ è negato.
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.
Il file in destinationFileName’ contiene una colonna (:) nel mezzo della riga.
SetSource(Stream)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(Stream source)Parameters
source Stream
Il flusso di input per l’archivio.
Examples
using (var archive = new GzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.gz");
}SetSource(FileInfo)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
Il riferimento a un file da comprimere.
Examples
using (var archive = new GzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.gz");
}SetSource(Le string)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(string path)Parameters
path string
Il modo in cui il file viene compreso.
Examples
Ouvrir un fichier par voie et l’extraire à un
using (var archive = new GzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.gz");
}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.
SetSource(TarArchive)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(TarArchive tarArchive)Parameters
tarArchive TarArchive
L’archivio deve essere compreso.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var gzippedArchive = new GzipArchive())
{
gzippedArchive.SetSource(tarArchive);
gzippedArchive.Save("archive.tar.gz");
}
}Remarks
Utilizzare questo metodo per compilare archivio congiunto tar.gz.
