Class Bzip2Archive

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

object Bzip2Archive

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

EndOfStreamException

La prima fine del flusso.

InvalidDataException

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

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

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.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

Il file è già aperto.

EndOfStreamException

La prima fine del flusso.

InvalidDataException

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

ArgumentException

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

FileInfo

Informazioni sul file estratto.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

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.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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.

SecurityException

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

NotSupportedException

Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“C:”).

ArgumentException

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 (:).

IOException

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

Stream

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

InvalidOperationException

La fonte dei dati da archiviare non è stata fornita.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

La fonte del file è letta solo o è un directory.

DirectoryNotFoundException

Il percorso di sorgente del file specificato è invalido, ad esempio essere su un disco non cartografato.

IOException

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La destinationFileName’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file destinationFileName’ è negato.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

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.

NotSupportedException

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.

 Italiano