Class Lz4Archive

Class Lz4Archive

Název místa: Aspose.Zip.Lz4 Sbírka: Aspose.Zip.dll (25.5.0)

Tato třída představuje LZ4 archivní soubor. Použijte ho k extrahování nebo složení archívů.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Dědiční členové

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

Constructors

Lz4Archive(Stream)

Začíná nový příklad třídy Aspose.Zip.Lz4.Lz4Archive připravené k dekompresován.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

Zdroj z archivu.

Examples

Otevřete archiv z toku a extrahujte ho do

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

Remarks

Tento konstruktor není dekompresní. viz Aspose.Zip.Lz4.Lz4Archive.Otevřená metoda dekompresn.

Exceptions

ArgumentException

Nelze číst z sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

code class=“paramref”>sourceStream’ má nesprávný podpis.

Lz4Archive(Stringová)

Začíná nový příklad třídy Aspose.Zip.Lz4.Lz4Archive.

public Lz4Archive(string path)

Parameters

path string

Cesta do archivního souboru.

Examples

Otevřete archiv z souboru podle trasy a extrahujte ho do

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

Remarks

Tento konstruktor není dekompresní. viz Aspose.Zip.Lz4.Lz4Archive.Otevřená metoda dekompresn.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

EndOfStreamException

Soubor je příliš krátk.

InvalidDataException

daje v souboru mají nesprávný podpis.

Lz4Archive(Lz4ArchiveSetting)

Začíná nový příklad třídy Aspose.Zip.Lz4.Lc4Archiv připraven pro kompresi.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

Složení složeného archivu.

Methods

Dispose()

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

public void Dispose()

Dispose(Bolíček)

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Je nutné zlikvidovat spravované zdroje.

Extract(Stringová)

Vytahuje archiv do souboru cestou.

public FileInfo Extract(string path)

Parameters

path string

Cesta k cílovému souboru.Pokud soubor již existuje, bude přepsan.

Returns

FileInfo

Informace o vydaném souboru.

Exceptions

EndOfStreamException

Zdrojový proud je příliš krátk.

InvalidDataException

Nesprávné byty nalezeny při dekódován.

NotSupportedException

Tato verze LZ4 není podporována.

Extract(Stream)

Vytahuje archiv do poskytnutého toku.

public void Extract(Stream destination)

Parameters

destination Stream

Destinace stream. musí být psateln.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Zdrojový proud je příliš krátk.

InvalidDataException

Nesprávné byty nalezeny při dekódován.

NotSupportedException

Tato verze LZ4 není podporována.

InvalidOperationException

Archiv je připraven pro kompozici.

ExtractToDirectory(Stringová)

Obsah archivu extrahuje do poskytnutého adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Cesta do adresáře umístit extrahované soubory do.

Remarks

Pokud adresář neexistuje, bude vytvořen.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Zadaná trasa, název souboru nebo obojí přesahuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasa menší než 248 znaků a název souboru musí být menší než 260 znak.

SecurityException

Návštěvník nemá požadované povolení k přístupu k stávajícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, trasa obsahuje znak kolonu (:) který není součástí označení disku (“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

dek určený cestou je soubor. -or- Název sítě není znám.

EndOfStreamException

Zdrojový proud je příliš krátk.

InvalidDataException

Nesprávné byty byly nalezeny při zahájení dekódován.

InvalidOperationException

Archiv je připraven pro kompozici.

Open()

Otevře archiv pro extrahování a poskytuje tok s obsahem archivu.

public Stream Open()

Returns

Stream

Průtok, který představuje obsah archivu.

Examples

Extrahuje archiv a kopíruje extrahovaný obsah do streamování soubor.

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);
    }            
}

Můžete použít metodu Stream.CopyTo pro .NET 4.0 a vyšší: unpacked.Kopíto(vyvedeno);

Remarks

Přečtěte si z toku, abyste získali původní obsah souboru.

Exceptions

EndOfStreamException

Zdrojový proud je příliš krátk.

InvalidDataException

Nesprávné byty byly nalezeny při zahájení dekódován.

InvalidOperationException

Archiv je připraven pro kompozici.

Save(Stream)

Ušetří archiv lz4 do poskytnutého toku.

public void Save(Stream output)

Parameters

output Stream

Destinace v toku.

Examples

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

Remarks

Musí být vyhledatelné.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Archiv je připraven k extrakci. - nebo - Zdroj nebyl poskytnut.

Save(FileInfo)

Ušetří archiv lz4 k poskytnutému cílovému souboru.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, který se otevře jako cílový proud.

Examples

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

Exceptions

SecurityException

Volající nemá požadované povolení k otevření destinace <code class=“paramref'.

ArgumentException

Stránka je prázdná nebo obsahuje pouze bílé prostory.

FileNotFoundException

Soubor nebyl nalezen.

UnauthorizedAccessException

Cesta k souboru je čtená pouze nebo je adres.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

IOException

Soubor je již otevřen.

InvalidOperationException

Archiv je připraven k extrakci.

Save(Stringová)

Ušetří archiv na předloženém cílovém souboru.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu

ArgumentException

code class=“paramref”>destinationFileName’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru destinationFileName’ je odmítnut.

PathTooLongException

Uvedený destinationFileName’, název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasy menší než 248 znaků a název souboru musí být menší než 260 znak.

NotSupportedException

Soubor na destinationFileName’ obsahuje kolonku (:) uprostřed řádku.

InvalidOperationException

Archiv je připraven k extrakci.

SetSource(Stream)

Vložte obsah, který bude komprimován v archivu.

public void SetSource(Stream source)

Parameters

source Stream

Vstupní proud pro archiv.

Examples

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

Exceptions

InvalidOperationException

Archiv je připraven k extrakci.

SetSource(FileInfo)

Vložte obsah, který bude komprimován v archivu.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

odkaz na soubor, který má být komprimován.

Examples

Otevřete archiv z toku a extrahujte ho do

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

Exceptions

InvalidOperationException

Archiv je připraven k extrakci.

SetSource(Tarformát, Tarformát)

Vložte obsah, který bude komprimován v archivu.

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

Parameters

tarArchive TarArchive

Archiv by měl být komprimován.

format TarFormat

Definuje formát 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

Použijte tuto metodu k sestavování společného archivu tar.lz4.

SetSource(Stringová)

Vložte obsah, který bude komprimován v archivu.

public void SetSource(string path)

Parameters

path string

Způsob, jak dosáhnout komprese.

Examples

Otevřete archiv z souboru podle trasy a extrahujte ho do

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path” je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

InvalidOperationException

Tento archiv je připraven k extrakci.

 Čeština