Class Bzip2Archive
Il nome: Aspose.Zip.Bzip2 Assemblea: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta il file di archivio bzip2. utilizzarlo per compilare o estrarre archivi bzip2.
public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
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
bzip2 comprime i file utilizzando il blocco Burrows-Wheeler di sorveglianza algoritmo di compressione del testo, e Huffman di codifica.
Constructors
Bzip2Archive()
Inizia una nuova instanza della classe Aspose.Zip.Bzip2.Bzip2Archivato preparato per la compressione.
public Bzip2Archive()
Examples
Il seguente esempio mostra come comprimere un file.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}
Bzip2Archive(Riflessioni su Bzip2LoadOptions)
Inizia una nuova instanza della classe Aspose.Zip.Bzip2.Bzip2Archivato preparato per la decompressione.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)
Parameters
sourceStream
Stream
La fonte dell’archivio.
loadOptions
Bzip2LoadOptions
Le opzioni per caricare archivio con.
Examples
Aprire un archivio da un flusso ed estrarlo in un
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);
Remarks
Questo costruttore non decomprime. vedi Aspose.Zip.Bzip2.Bzip2Archive.Open metodo di decompressione.
Exceptions
La prima fine del flusso.
Sottoscrizioni sbagliate.
Bzip2Archive(Riflessioni su Bzip2LoadOptions)
Inizia una nuova instanza della classe Aspose.Zip.Bzip2.Bzip2Archivato preparato per la decompressione.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)
Parameters
path
string
Il percorso verso l’archivio.
loadOptions
Bzip2LoadOptions
Le opzioni per caricare archivio con.
Examples
Aprire un archivio dal file per percorso ed estrarlo in un
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);
Remarks
Questo costruttore non decomprime. vedi Aspose.Zip.Bzip2.Bzip2Archive.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 non è trovato.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file è già aperto.
La prima fine del flusso.
Sottoscrizioni sbagliate.
Methods
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.
Extract(Stream)
L’archivio viene estratto nel flusso fornito.
public void Extract(Stream destination)
Parameters
destination
Stream
Destinazione Stream. deve essere scritta.
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Extract(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 file non è trovato.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file è già aperto.
ExtractToDirectory(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.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“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
Uso di:Stream decompressed = archive.Open();
.NET 4.0 e superiore - utilizza il metodo Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 e prima - copiare manualmente i byti:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Remarks
Read from the stream to get the original content of the file. See examples section.
### <a id="Aspose_Zip_Bzip2_Bzip2Archive_Save_System_IO_Stream_Aspose_Zip_Bzip2_Bzip2SaveOptions_"></a> Save\(Stream, Bzip2SaveOptions\)
Saves archive to the stream provided.
```csharp
public void Save(Stream outputStream, Bzip2SaveOptions saveOptions = null)
Parameters
outputStream
Stream
Il flusso di destinazione.
saveOptions
Bzip2SaveOptions
Opzioni per salvare un archivio bzip2. se non specificato, 900 Kb di dimensione del blocco sarebbe usato.
Examples
Inserisci i dati compressi nel flusso di risposta http.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Remarks
Deve essere scritta.
Exceptions
La fonte dei dati da archiviare non è stata fornita.
outputStream’ is not writable.
La fonte del file è letta solo o è un directory.
Il percorso di sorgente del file specificato è invalido, ad esempio essere su un disco non cartografato.
La fonte del file è già aperta.
Save(String, Bzip2SaveOptions)
Salva archivio a un file di destinazione fornito.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)
Parameters
destinationFileName
string
Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.
saveOptions
Bzip2SaveOptions
Opzioni per salvare un archivio bzip2. se non specificato, 900 Kb di dimensione del blocco sarebbe usato.
Examples
Scrivere i dati compressi per file.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}
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 (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}
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 (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}
SetSource(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
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}
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(TarArchivio, TarFormato)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)
Parameters
tarArchive
TarArchive
L’archivio deve essere compreso.
format
TarFormat
Definisce il formato tar header.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var bzippedArchive = new Bzip2Archive())
{
bzippedArchive.SetSource(tarArchive);
bzippedArchive.Save("archive.tar.bz2");
}
}
Remarks
Utilizzare questo metodo per compilare archivio congiunto tar.bz2.
SetSource(CioArchivio, CioFormato)
Metti il contenuto per essere compreso all’interno dell’archivio.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)
Parameters
cpioArchive
CpioArchive
L’archivio Cpio deve essere compreso.
format
CpioFormat
Definisce il formato cpio header.
Examples
using (var cpioArchive = new CpioArchive())
{
cpioArchive.CreateEntry("first.bin", "data1.bin");
cpioArchive.CreateEntry("second.bin", "data2.bin");
using (var bzippedArchive = new Bzip2Archive())
{
bzippedArchive.SetSource(cpioArchive);
bzippedArchive.Save("archive.cpio.bz2");
}
}
Remarks
Utilizzare questo metodo per compilare un archivio congiunto cpio.bz2.