Class Lz4Archive

Class Lz4Archive

Namn på plats: Aspose.Zip.Lz4 Sammanfattning: Aspose.Zip.dll (25.5.0)

Den här klassen representerar LZ4 arkivfilen. Använd den för att extrahera eller komponera Lz4-arkiv.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Arvsmedlemmar

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

Constructors

Lz4Archive(Stream)

Initialiserar en ny instans av Aspose.Zip.Lz4.Lz4Archivklassen förberedd för dekomprimering.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

Källan till arkivet.

Examples

Öppna ett arkiv från en ström och extrahera det till en

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

Remarks

Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Lz4.Lz4Archive.Öppna metoder för dekomprimering.

Exceptions

ArgumentException

Kan inte läsas från sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

sourceStream’ har fel signatur.

Lz4Archive(Sträng)

Initialiserar en ny instans av Aspose.Zip.Lz4.Lz4Archivklassen.

public Lz4Archive(string path)

Parameters

path string

Vägen till arkivfilen.

Examples

Öppna ett arkiv från filen per väg och extrahera det till en

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

Remarks

Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Lz4.Lz4Archive.Öppna metoder för dekomprimering.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

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.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

EndOfStreamException

Filen är för kort.

InvalidDataException

Data i filen har fel signatur.

Lz4Archive(Lz4ArchiveSetting)

Initialiserar en ny instans av Aspose.Zip.Lz4.Lc4Archivklassen förberedd för komprimering.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

Utformningen av den sammansatta arkivet.

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

FileInfo

Information om en extraherad fil.

Exceptions

EndOfStreamException

Källströmmen är för kort.

InvalidDataException

Felaktiga byter hittade under dekryptering.

NotSupportedException

Den här versionen av LZ4 stöds inte.

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 (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Källströmmen är för kort.

InvalidDataException

Felaktiga byter hittade under dekryptering.

NotSupportedException

Den här versionen av LZ4 stöds inte.

InvalidOperationException

Arkivet är förberett för komposition.

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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.

SecurityException

Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.

NotSupportedException

Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“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 som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.

EndOfStreamException

Källströmmen är för kort.

InvalidDataException

Fel byter hittade medan initialisera dekryptering.

InvalidOperationException

Arkivet är förberett för komposition.

Open()

Öppnar arkivet för extraction och ger en ström med arkivinnehåll.

public Stream Open()

Returns

Stream

Strömmen som representerar innehållet i arkivet.

Examples

Extraherar arkivet och kopierar extraherat innehåll till filström.

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

Du kan använda Stream.CopyTo-metoden för .NET 4.0 och högre: unpacked.KopiTo(utdraget);

Remarks

Läs från strömmen för att få det ursprungliga innehållet i en fil. Se exempel avsnitt.

Exceptions

EndOfStreamException

Källströmmen är för kort.

InvalidDataException

Fel byter hittade medan initialisera dekryptering.

InvalidOperationException

Arkivet är förberett för komposition.

Save(Stream)

Spara lz4 arkiv till den tillhandahållna strömmen.

public void Save(Stream output)

Parameters

output Stream

Destination strömmar.

Examples

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

Remarks

Måste vara sökbar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Arkivet är förberett för utvinning. - eller - Källan har inte levererats.

Save(FileInfo)

Spara lz4 arkiv till avsedd fil som tillhandahålls.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, som öppnas som destinationström.

Examples

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

Exceptions

SecurityException

Ringaren har inte nödvändig tillåtelse att öppna destination".

ArgumentException

Filvägen är tom eller innehåller endast vita utrymmen.

FileNotFoundException

Filen hittades inte.

UnauthorizedAccessException

Vägen till filen är läsbart eller är en katalog.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

IOException

Filen är redan öppen.

InvalidOperationException

Arkivet är förberett för utvinning.

Save(Sträng)

Spara arkiv till den angivna destinationsfilen.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt

ArgumentException

destinationFileName’ är tom, innehåller endast vita utrymmen, eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Tillgång till filen destinationFileName’ vägras.

PathTooLongException

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.

NotSupportedException

Filen i destinationFileName’ innehåller en kolumn (:) i mitten av raden.

InvalidOperationException

Arkivet är förberett för utvinning.

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 (var archive = new Lz4Archive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lz4");
}

Exceptions

InvalidOperationException

Arkivet är förberett för utvinning.

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

Öppna ett arkiv från en ström och extrahera det till en

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

Exceptions

InvalidOperationException

Arkivet är förberett för utvinning.

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

Remarks

Använd den här metoden för att samla tar.lz4 arkiv.

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

Öppna ett arkiv från filen per väg och extrahera det till en

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

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.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

InvalidOperationException

Detta arkiv är förberett för utvinning.

 Svenska