Class Bzip2Archive

Class Bzip2Archive

Nazwa przestrzeń: Aspose.Zip.Bzip2 Zestawienie: Aspose.Zip.dll (25.5.0)

Ta klasa reprezentuje plik archiwum bzip2. użyj go do tworzenia lub ekstrakcji plików archiwum bzip2.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Bzip2Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Dziedziczeni członkowie

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

Remarks

bzip2 kompresuje pliki za pomocą bloku Burrows-Wheeler sortowania algorytmu kompresji tekstu i kodowania Huffman. zobacz więcej: https://en.wikipedia.org/wiki/Bzip2

Constructors

Bzip2Archive()

Inicjalizuje nowy przykład klasy Aspose.Zip.Bzip2.Bzip2Archive przygotowane do kompresji.

public Bzip2Archive()

Examples

Poniższy przykład pokazuje, jak kompresować plik.

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

Bzip2Archive(Strumień, Bzip2LoadOptions)

Inicjalizuje nowy przykład klasy Aspose.Zip.Bzip2.Bzip2Archive przygotowany do dekompresji.

public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)

Parameters

sourceStream Stream

Źródło tego archiwum.

loadOptions Bzip2LoadOptions

Opcje do pobierania archiwum.

Examples

Otwórz archiwum z strumienia i wyciągnij go do

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

Remarks

Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Bzip2.Bzip2Archive.Otwarta metoda dekompresji.

Exceptions

EndOfStreamException

Przedwczesny koniec strumienia.

InvalidDataException

Nieprawidłowe podpisy bajtów.

Bzip2Archive(strumień, Bzip2LoadOptions)

Inicjalizuje nowy przykład klasy Aspose.Zip.Bzip2.Bzip2Archive przygotowany do dekompresji.

public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)

Parameters

path string

Droga do archiwum.

loadOptions Bzip2LoadOptions

Opcje do pobierania archiwum.

Examples

Otwórz archiwum z pliku przez ścieżkę i wyciągnij go do

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

Remarks

Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Bzip2.Bzip2Archive.Otwarta metoda dekompresji.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path’ zawiera kolumnę (:) w środku paska.

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

IOException

Archiwum jest już otwarte.

EndOfStreamException

Przedwczesny koniec strumienia.

InvalidDataException

Nieprawidłowe podpisy bajtów.

Methods

Dispose()

Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.

public void Dispose()

Dispose(Bool)

Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Czy zarządzane zasoby powinny zostać usunięte?

Extract(Stream)

Wyciągnij archiwum do dostarczonego przepływu.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. musi być pisemny.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

Extract(strumień)

Wyciągnij archiwum do pliku przez ścieżkę.

public FileInfo Extract(string path)

Parameters

path string

Droga do pliku docelowego.Jeśli plik już istnieje, zostanie on przesłany.

Returns

FileInfo

Informacje o wydanym pliku.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path’ zawiera kolumnę (:) w środku paska.

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

IOException

Archiwum jest już otwarte.

ExtractToDirectory(strumień)

Wyciąga treść archiwum do dostarczonego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Droga do katalogu, aby umieścić wyciągnięte pliki.

Remarks

Jeśli dyrektywa nie istnieje, zostanie ona utworzona.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

SecurityException

Odwołujący nie posiada wymaganej pozwolenia na dostęp do istniejącego katalogu.

NotSupportedException

Jeśli dyrektywa nie istnieje, ścieżka zawiera znak kolumny (:) który nie jest częścią etykiety napędu (“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

Dyskusja określona przez ścieżkę jest plikiem. -or- Nazwa sieci nie jest znana.

Open()

Otwiera archiwum do ekstrakcji i zapewnia strumień z treścią archiwum.

public Stream Open()

Returns

Stream

Strumień, który reprezentuje treść archiwum.

Examples

Wykorzystanie :Stream decompressed = archive.Open();

.NET 4.0 i wyższy - użyj metody Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 i wcześniej - kopiować byty ręcznie:

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

Przepływ docelowy.

saveOptions Bzip2SaveOptions

Opcje do przechowywania archiwum bzip2. jeśli nie określono, rozmiar bloku 900 Kb byłby używany.

Examples

Wpisz kompresowane dane do strumienia odpowiedzi http.

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

Remarks

Musi być pisemny.

Exceptions

InvalidOperationException

Źródło danych do archiwizacji nie zostało udostępnione.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

Źródło pliku jest czytane wyłącznie lub jest katalogu.

DirectoryNotFoundException

Określoną ścieżkę źródłową pliku jest nieważna, np. bycie na dysku bez mapowania.

IOException

Źródło pliku jest już otwarte.

Save(strumień, Bzip2SaveOptions)

Zapisz archiwum do dostarczonego pliku docelowego.

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

Parameters

destinationFileName string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

saveOptions Bzip2SaveOptions

Opcje do przechowywania archiwum bzip2. jeśli nie określono, rozmiar bloku 900 Kb byłby używany.

Examples

Wpisz kompresowane dane do pliku.

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

destinationFileName’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku destinationFileName’ jest odrzucony.

PathTooLongException

Określenie destinationFileName’, nazwa pliku, lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w adresie destinationFileName’ zawiera kolumnę (:) w środku paska.

SetSource(Stream)

Ustaw zawartość do kompresji w archiwum.

public void SetSource(Stream source)

Parameters

source Stream

Przepływ wejściowy do archiwum.

Examples

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

SetSource(FileInfo)

Ustaw zawartość do kompresji w archiwum.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Odniesienie do pliku do kompresji.

Examples

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

SetSource(strumień)

Ustaw zawartość do kompresji w archiwum.

public void SetSource(string path)

Parameters

path string

Ścieżka do rejestracji do kompresji.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Klient nie posiada wymaganego zezwolenia na dostęp.

ArgumentException

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

UnauthorizedAccessException

Dostęp do pliku path" jest odrzucony.

PathTooLongException

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

NotSupportedException

Plik w path’ zawiera kolumnę (:) w środku paska.

SetSource(Artykuły, TarFormat)

Ustaw zawartość do kompresji w archiwum.

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

Parameters

tarArchive TarArchive

Archiwum do kompresji.

format TarFormat

Definicja formatu 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

Użyj tej metody do tworzenia wspólnego archiwum tar.bz2.

SetSource(CpioArchive, CpioFormat)

Ustaw zawartość do kompresji w archiwum.

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

Parameters

cpioArchive CpioArchive

Archiwum Cpio do kompresji.

format CpioFormat

Definicja formatu 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

Użyj tej metody do tworzenia wspólnego archiwum cpio.bz2.

 Polski