Class Bzip2Archive
Namn på plats: Aspose.Zip.Bzip2 Sammanfattning: Aspose.Zip.dll (25.5.0)
Denna klass representerar bzip2 arkivfilen. Använd den för att komponera eller extrahera bzip2 arkiv.
public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Arvsmedlemmar
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
bzip2 komprimerar filer med hjälp av Burrows-Wheeler block sortering text komprimering algoritm, och Huffman kodning. Se mer: https://en.wikipedia.org/wiki/Bzip2
Constructors
Bzip2Archive()
Initialiserar en ny instans av Aspose.Zip.Bzip2.Bzip2Archivklassen förberedd för komprimering.
public Bzip2Archive()Examples
Följande exempel visar hur man komprimerar en fil.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Bzip2Archive(Ström, Bzip2LoadOptions)
Initialiserar en ny instans av Aspose.Zip.Bzip2.Bzip2Archivklassen förberedd för dekomprimering.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)Parameters
sourceStream Stream
Källan till arkivet.
loadOptions Bzip2LoadOptions
Alternativ för att ladda arkiv med.
Examples
Öppna ett arkiv från en ström och extrahera det till en
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);Remarks
Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Bzip2.Bzip2Archive.Open metod för dekomprimering.
Exceptions
För tidig ström slut.
Fel signatur bytes.
Bzip2Archive(Sträng, Bzip2LoadOptions)
Initialiserar en ny instans av Aspose.Zip.Bzip2.Bzip2Archivklassen förberedd för dekomprimering.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)Parameters
path string
Vägen till arkivfilen.
loadOptions Bzip2LoadOptions
Alternativ för att ladda arkiv med.
Examples
Öppna ett arkiv från filen per väg och extrahera det till en
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);Remarks
Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Bzip2.Bzip2Archive.Open metod för dekomprimering.
Exceptions
path’ is null.
Sökanden har inte behörig tillstånd att komma åt.
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Filen hittades inte.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
För tidig ström slut.
Fel signatur bytes.
Methods
Dispose()
Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.
public void Dispose()Dispose(Bool)
Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Oavsett om de förvaltade resurserna ska utplånas.
Extract(Stream)
Extraherar arkivet till den tillhandahållna strömmen.
public void Extract(Stream destination)Parameters
destination Stream
Destination stream. måste vara skribar.
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(Sträng)
Extraherar arkivet till filen per väg.
public FileInfo Extract(string path)Parameters
path string
Vägen till målfilen. om filen redan existerar, kommer den att översättas.
Returns
Information om den extraherade filen.
Exceptions
path’ is null.
Sökanden har inte behörig tillstånd att komma åt.
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Filen hittades inte.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
ExtractToDirectory(Sträng)
Extraherar innehållet i arkivet till den angivna katalogen.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Vägen till katalogen för att placera de extraherade filerna i.
Remarks
Om katalogen inte existerar kommer den att skapas.
Exceptions
destinationDirectory’ is null.
Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägarna vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.
Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.
Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“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 (:).
Den katalog som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.
Open()
Öppnar arkivet för extraction och ger en ström med arkivinnehåll.
public Stream Open()Returns
Strömmen som representerar innehållet i arkivet.
Examples
Användning :Stream decompressed = archive.Open();
.NET 4.0 och högre - använd Stream.CopyTo metod:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 och tidigare - kopiera byter manuellt:
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
Destination strömmar.
saveOptions Bzip2SaveOptions
Alternativ för att spara en bzip2 arkiv. Om inte anges, skulle 900 Kb blockstorlek användas.
Examples
Skriv komprimerade data till HTTP responsström.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
Måste vara skribar.
Exceptions
Källan till de uppgifter som ska arkiveras har inte lämnats.
outputStream’ is not writable.
Filkällan är enbart läst eller är en katalog.
Den angivna filkällavägen är ogiltig, till exempel att vara på en icke-mappad disk.
Filkällan är redan öppen.
Save(Sträng, Bzip2SaveOptions)
Spara arkiv till en avsedd fil som tillhandahålls.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)Parameters
destinationFileName string
Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.
saveOptions Bzip2SaveOptions
Alternativ för att spara en bzip2 arkiv. Om inte anges, skulle 900 Kb blockstorlek användas.
Examples
Skriv komprimerade data till filer.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}Exceptions
destinationFileName’ is null.
Sökanden har inte behörig tillstånd att komma åt.
destinationFileName’ är tom, innehåller endast vita utrymmen, eller innehåller ogiltiga tecken.
Tillgång till filen destinationFileName’ vägras.
Den angivna destinationFileName’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Filen i destinationFileName’ innehåller en kolumn (:) i mitten av raden.
SetSource(Stream)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(Stream source)Parameters
source Stream
Inträdesflöde för arkivet.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}SetSource(FileInfo)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
Referensen till en fil som ska komprimeras.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}SetSource(Sträng)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(string path)Parameters
path string
Vägen att filera för att komprimeras.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Exceptions
path’ is null.
Sökanden har inte behörig tillstånd att komma åt.
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
SetSource(TarArchiv, TarFormat)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)Parameters
tarArchive TarArchive
Tar arkiv att komprimeras.
format TarFormat
Definiera 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
Använd den här metoden för att samla tar.bz2 arkiv.
SetSource(CpioArchiv, CpioFormat)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)Parameters
cpioArchive CpioArchive
Cpio arkiv för att komprimeras.
format CpioFormat
Definiera 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
Använd den här metoden för att komponera ett gemensamt cpio.bz2 arkiv.
