Class Bzip2Archive

Class Bzip2Archive

Navne til: Aspose.Zip.Bzip2 Sammensætning: Aspose.Zip.dll (25.5.0)

Denne klasse repræsenterer bzip2 arkivfil. Brug det til at komponere eller udveksle bzip2 arkiver.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Bzip2Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

De arvede medlemmer

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

bzip2 komprimerer filer ved hjælp af Burrows-Wheeler blok sortering tekst kompression algoritme, og Huffman kodning. Se mere: https://en.wikipedia.org/wiki/Bzip2

Constructors

Bzip2Archive()

Initialiserer en ny instans af Aspose.Zip.Bzip2.Bzip2Archive klasse forberedt til komprimering.

public Bzip2Archive()

Examples

Følgende eksempel viser, hvordan man komprimerer en fil.

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

Bzip2Archive(Strøm, Bzip2LoadOptions)

Initialiserer en ny instans af Aspose.Zip.Bzip2.Bzip2Archive klasse forberedt til dekomprimering.

public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)

Parameters

sourceStream Stream

kilden til arkivet.

loadOptions Bzip2LoadOptions

De muligheder for at oplade arkiver med.

Examples

Åbn et arkiv fra en strøm og uddrag det til en

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
  archive.Open().CopyTo(ms);

Remarks

Denne konstruktør dekomprimerer ikke. Se Aspose.Zip.Bzip2.Bzip2Archive.Open metode til dekomprimering.

Exceptions

EndOfStreamException

Tidlig strøm afslutter.

InvalidDataException

Den forkerte underskrift byte.

Bzip2Archive(String, Bzip2LoadOptions)

Initialiserer en ny instans af Aspose.Zip.Bzip2.Bzip2Archive klasse forberedt til dekomprimering.

public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)

Parameters

path string

Vejen til arkiveret.

loadOptions Bzip2LoadOptions

De muligheder for at oplade arkiver med.

Examples

Åbne et arkiv fra filen efter vej og uddrag det til en

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
  archive.Open().CopyTo(ms);

Remarks

Denne konstruktør dekomprimerer ikke. Se Aspose.Zip.Bzip2.Bzip2Archive.Open metode til dekomprimering.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

FileNotFoundException

Filen er ikke fundet.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

EndOfStreamException

Tidlig strøm afslutter.

InvalidDataException

Den forkerte underskrift byte.

Methods

Dispose()

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

Dispose(Bool)

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Om de forvaltede ressourcer skal fjernes.

Extract(Stream)

Udveksler arkivet til den leverede strøm.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. skal være skriftlig.

Examples

using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

Extract(String)

Udveksler arkivet til filen ved vej.

public FileInfo Extract(string path)

Parameters

path string

Hvis filen allerede eksisterer, vil den blive overskrevet.

Returns

FileInfo

Oplysninger om den udvundne fil.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

FileNotFoundException

Filen er ikke fundet.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

ExtractToDirectory(String)

Udveksler indholdet af arkivet til den leverede katalog.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Vejen til katalogen til at placere de udvundne filer i.

Remarks

Hvis katalogen ikke eksisterer, vil den blive oprettet.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.

SecurityException

Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.

NotSupportedException

Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“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

Den katalog, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.

Open()

bner arkivet til ekstraktion og giver en strøm med arkivindhold.

public Stream Open()

Returns

Stream

Den strøm, der repræsenterer indholdet af arkivet.

Examples

Brug af:Stream decompressed = archive.Open();

.NET 4.0 og højere - brug Stream.CopyTo metode:decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 og før - kopiering af byter manuelt:

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

Destinationstrøm.

saveOptions Bzip2SaveOptions

Alternativer til at gemme en bzip2 arkiv. Hvis ikke angivet, vil 900 Kb blok størrelse blive brugt.

Examples

Skriv komprimerede data til http responsstrøm.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Remarks

Det skal være skriftligt.

Exceptions

InvalidOperationException

Den kilde til data, der skal arkiveres, er ikke givet.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

Filkilden er bare læst eller er en katalog.

DirectoryNotFoundException

Den angivne fil kildevej er ugyldig, som f.eks. at være på en ubemappet disk.

IOException

Filkilden er allerede åben.

Save(String, Bzip2SaveOptions)

Sparer arkiver til en bestemmelsesfil, der er leveret.

public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)

Parameters

destinationFileName string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

saveOptions Bzip2SaveOptions

Alternativer til at gemme en bzip2 arkiv. Hvis ikke angivet, vil 900 Kb blok størrelse blive brugt.

Examples

Skriv komprimerede data til filer.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bz2");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

Den destinationFileName’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn.

UnauthorizedAccessException

Tilgang til filen destinationFileName’ er nægtet.

PathTooLongException

Den angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Fil på destinationFileName’ indeholder en kolonne (:) i midten af ringen.

SetSource(Stream)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(Stream source)

Parameters

source Stream

Indtægtsstrøm for arkivet.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
    archive.Save("archive.bz2");
}

SetSource(FileInfo)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Den reference til en fil, der skal komprimeres.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.bz2");
}

SetSource(String)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(string path)

Parameters

path string

Vejen til fil at blive komprimeret.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

SetSource(Fællesskab, TarFormat)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

Arkiverne skal komprimeres.

format TarFormat

Definition af tar header format.

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

Brug denne metode til at komponere fælles tar.bz2 arkiv.

SetSource(CpioArchive og CpioFormat)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)

Parameters

cpioArchive CpioArchive

Cpio arkiver skal komprimeres.

format CpioFormat

Definition af cpio header format.

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

Brug denne metode til at komponere fælles cpio.bz2 arkiv.

 Dansk