Class Lz4Archive

Class Lz4Archive

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

Ta klasa reprezentuje plik archiwum LZ4.Użyj go do ekstrakcji lub kompozycji archivów L Z4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

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

Constructors

Lz4Archive(Stream)

Inicjalizuje nową instancję klasy Aspose.Zip.Lz4.Lz4Archive przygotowanej do dekompresji.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

Źródło tego archiwum.

Examples

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

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

Remarks

Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Lz4.Lz4Archive.Otwarta metoda dekompresji.

Exceptions

ArgumentException

Nie można przeczytać z sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

sourceStream’ ma niewłaściwy podpis.

Lz4Archive(strumień)

Inicjalizuje nowy przykład klasy Aspose.Zip.Lz4.Lz4Archive.

public Lz4Archive(string path)

Parameters

path string

Droga do archiwum.

Examples

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

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

Remarks

Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Lz4.Lz4Archive.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.

EndOfStreamException

Plik jest zbyt krótki.

InvalidDataException

Dane zawarte w pliku mają niewłaściwy podpis.

Lz4Archive(Lz4ArchiveSetting)

Inicjalizuje nową instancję klasy Aspose.Zip.Lz4.Lc4Archiwum przygotowane do kompresji.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

Ustawienie złożonego archiwum.

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(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

EndOfStreamException

Strumień źródłowy jest zbyt krótki.

InvalidDataException

Niewłaściwe bajty znaleziono podczas dekodowania.

NotSupportedException

Ta wersja LZ4 nie jest obsługiwana.

Extract(Stream)

Wyciągnij archiwum do dostarczonego przepływu.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. musi być pisemny.

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Strumień źródłowy jest zbyt krótki.

InvalidDataException

Niewłaściwe bajty znaleziono podczas dekodowania.

NotSupportedException

Ta wersja LZ4 nie jest obsługiwana.

InvalidOperationException

Archiwum jest przygotowane do kompozycji.

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.

EndOfStreamException

Strumień źródłowy jest zbyt krótki.

InvalidDataException

Znaleziono niewłaściwe bajty podczas inicjalizacji dekodowania.

InvalidOperationException

Archiwum jest przygotowane do kompozycji.

Open()

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

public Stream Open()

Returns

Stream

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

Examples

Wyciąga archiwum i kopiuje wyciągnięte treści do strumienia plików.

using (var archive = new Lz4Archive("archive.lz4"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Możesz użyć metody Stream.CopyTo dla .NET 4.0 i wyższych: unpacked.KopiTo(wyciągnięte);

Remarks

Przeczytaj z strumienia, aby uzyskać oryginalną zawartość pliku. zobacz sekcję Przykłady.

Exceptions

EndOfStreamException

Strumień źródłowy jest zbyt krótki.

InvalidDataException

Znaleziono niewłaściwe bajty podczas inicjalizacji dekodowania.

InvalidOperationException

Archiwum jest przygotowane do kompozycji.

Save(Stream)

Oszczędza archiwum lz4 do dostarczonego przepływu.

public void Save(Stream output)

Parameters

output Stream

Przepływ docelowy.

Examples

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

Remarks

Musi być poszukiwana.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Archiwum jest przygotowane do ekstrakcji. - lub - Źródło nie zostało dostarczone.

Save(FileInfo)

Oszczędza archiwum lz4 do dostarczonego pliku docelowego.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, który zostanie otwarty jako strumień docelowy.

Examples

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

Exceptions

SecurityException

Wzywacz nie ma wymaganej zgody na otwarcie miejsca docelowego .

ArgumentException

Droga pliku jest pusta lub zawiera tylko białe przestrzenie.

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

Ścieżka do pliku jest czytana tylko lub jest katalogu.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

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

IOException

Archiwum jest już otwarte.

InvalidOperationException

Archiwum jest przygotowane do ekstrakcji.

Save(strumień)

Zapisz archiwum do dostarczonego pliku docelowego.

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

using (var archive = new LZ4Archive())
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

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.

InvalidOperationException

Archiwum jest przygotowane do ekstrakcji.

SetSource(Stream)

Ustaw zawartość do kompresji w archiwum.

public void SetSource(Stream source)

Parameters

source Stream

Przepływ wejściowy do archiwum.

Examples

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

Exceptions

InvalidOperationException

Archiwum jest przygotowane do ekstrakcji.

SetSource(FileInfo)

Ustaw zawartość do kompresji w archiwum.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Odniesienie do pliku do kompresji.

Examples

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

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

Exceptions

InvalidOperationException

Archiwum jest przygotowane do ekstrakcji.

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 lz4Archive = new Lz4Archive())
    {
        lz4Archive.SetSource(tarArchive);
        lz4Archive.Save("archive.tar.lz4");
    }
}

Remarks

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

SetSource(strumień)

Ustaw zawartość do kompresji w archiwum.

public void SetSource(string path)

Parameters

path string

Ścieżka do rejestracji do kompresji.

Examples

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

using (var archive = new Lz4Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

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.

InvalidOperationException

Archiwum jest przygotowane do ekstrakcji.

 Polski