Class Lz4Archive

Class Lz4Archive

De naam: Aspose.Zip.Lz4 Verzameling: Aspose.Zip.dll (25.5.0)

Deze klasse vertegenwoordigt LZ4 archiefbestand. Gebruik het om te extraheren of te composeren Lz4 bestanden.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Geëerbiede leden

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

Constructors

Lz4Archive(Stream)

Initialiseert een nieuwe instantie van de Aspose.Zip.Lz4.Lz4Archiefklasse voorbereid voor decompressie.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

De bron van het archief.

Examples

Open een archief van een stroom en extraheren naar een

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

Remarks

Zie Aspose.Zip.Lz4.Lz4Archive.Open methode voor decompressie.

Exceptions

ArgumentException

Niet te lezen van sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

De sourceStream’ heeft een verkeerde handtekening.

Lz4Archive(String)

Initialiseert een nieuwe instantie van de Aspose.Zip.Lz4.Lz4Archiefklasse.

public Lz4Archive(string path)

Parameters

path string

De weg naar het archiefbestand.

Examples

Open een archief van het bestand per pad en extraheren naar een

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

Remarks

Zie Aspose.Zip.Lz4.Lz4Archive.Open methode voor decompressie.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ bevat een kolom (:) in het midden van de string.

EndOfStreamException

Het bestand is te kort.

InvalidDataException

De gegevens in het bestand hebben de verkeerde handtekening.

Lz4Archive(Lz4ArchiveSetting)

Initialiseert een nieuwe instantie van de Aspose.Zip.Lz4. Lz4Archiefklasse voorbereid voor compressie.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

De opstelling van het gecombineerde archief.

Methods

Dispose()

Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.

public void Dispose()

Dispose(Bool)

Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Of de beheerde middelen moeten worden afgebroken.

Extract(String)

Extract het archief naar het bestand per pad.

public FileInfo Extract(string path)

Parameters

path string

De route naar bestand bestemming.Als het bestand al bestaat, zal het worden overgeschreven.

Returns

FileInfo

Informatie over een geïntroduceerd bestand.

Exceptions

EndOfStreamException

De bronstromen zijn te kort.

InvalidDataException

Onjuiste bytes gevonden tijdens het decoderen.

NotSupportedException

Deze LZ4 versie is niet ondersteund.

Extract(Stream)

Extract het archief naar de verstrekte stroom.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. moet geschreven zijn.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

De bronstromen zijn te kort.

InvalidDataException

Onjuiste bytes gevonden tijdens het decoderen.

NotSupportedException

Deze LZ4 versie is niet ondersteund.

InvalidOperationException

Het archief is voorbereid op de samenstelling.

ExtractToDirectory(String)

Verwijder de inhoud van het archief naar het verstrekte directory.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

De route naar het directory om de geïntroduceerde bestanden in te plaatsen.

Remarks

Als de directory niet bestaat, wordt deze gemaakt.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

De aangegeven pad, bestandnaam of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens en bestandnamen moeten minder dan 260 tekens zijn.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen tot de bestaande directory.

NotSupportedException

Als de directory niet bestaat, bevat de route een colon karakter (:) dat niet deel uitmaakt van een drive label (“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

De door de route aangegeven directory is een bestand. -or- De netwerknaam is niet bekend.

EndOfStreamException

De bronstromen zijn te kort.

InvalidDataException

Onjuiste bytes gevonden tijdens het initialiseren van de decodering.

InvalidOperationException

Het archief is voorbereid op de samenstelling.

Open()

Open het archief voor extractie en geeft een stroom met archiefinhoud.

public Stream Open()

Returns

Stream

De stroom die de inhoud van het archief vertegenwoordigt.

Examples

Extract het archief en kopieert geëxtracteerde inhoud naar bestandstromen.

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

U kunt de methode Stream.CopyTo voor .NET 4.0 en hoger gebruiken: ‘unpacked.KopieTo(extracted);’

Remarks

Lees van de stroom om de oorspronkelijke inhoud van een bestand te krijgen. zie voorbeelden sectie.

Exceptions

EndOfStreamException

De bronstromen zijn te kort.

InvalidDataException

Onjuiste bytes gevonden tijdens het initialiseren van de decodering.

InvalidOperationException

Het archief is voorbereid op de samenstelling.

Save(Stream)

Bespaart lz4 archief naar de verstrekte stroom.

public void Save(Stream output)

Parameters

output Stream

De bestemming stroom.

Examples

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

Remarks

Het moet zoektbaar zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Het archief is voorbereid voor extractie. - of - Bron is niet geleverd.

Save(FileInfo)

Bespaart lz4 archief naar bestemming bestand verstrekt.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, die zal worden geopend als bestemmingstromen.

Examples

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

Exceptions

SecurityException

De oproeker heeft niet de vereiste toestemming om de bestemming te openen.

ArgumentException

De bestandpad is leeg of bevat alleen witte ruimtes.

FileNotFoundException

Het bestand is niet gevonden.

UnauthorizedAccessException

De weg naar het bestand is alleen te lezen of is een directory.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

IOException

Het bestand is al open.

InvalidOperationException

Het archief is voorbereid op extractie.

Save(String)

Het archief wordt opgeslagen naar het bestand van bestemming.

public void Save(string destinationFileName)

Parameters

destinationFileName string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen

ArgumentException

De destinationFileName’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand destinationFileName’ wordt geweigerd.

PathTooLongException

De aangegeven destinationFileName’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand bij destinationFileName’ bevat een kolom (:) in het midden van de string.

InvalidOperationException

Het archief is voorbereid op extractie.

SetSource(Stream)

Stel de inhoud in om in het archief te worden gecomprimeerd.

public void SetSource(Stream source)

Parameters

source Stream

De ingangstromen voor het archief.

Examples

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

Exceptions

InvalidOperationException

Het archief is voorbereid op extractie.

SetSource(FileInfo)

Stel de inhoud in om in het archief te worden gecomprimeerd.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

De verwijzing naar een bestand om te worden gecomprimeerd.

Examples

Open een archief van een stroom en extraheren naar een

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

Exceptions

InvalidOperationException

Het archief is voorbereid op extractie.

SetSource(TarArchive en TarFormat)

Stel de inhoud in om in het archief te worden gecomprimeerd.

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

Parameters

tarArchive TarArchive

Tar archief te worden gecomprimeerd.

format TarFormat

Definieer het 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

Gebruik deze methode om het joint tar.lz4 archief te maken.

SetSource(String)

Stel de inhoud in om in het archief te worden gecomprimeerd.

public void SetSource(string path)

Parameters

path string

De weg naar het bestanden om gecomprimeerd te worden.

Examples

Open een archief van het bestand per pad en extraheren naar een

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ bevat een kolom (:) in het midden van de string.

InvalidOperationException

Dit archief is voorbereid op extractie.

 Nederlands