Class Lz4Archive

Class Lz4Archive

Navne til: Aspose.Zip.Lz4 Sammensætning: Aspose.Zip.dll (25.5.0)

Denne klasse repræsenterer LZ4 arkivfil. Brug det til at udveksle eller komponere lZ4-arkiver.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

De arvede medlemmer

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

Constructors

Lz4Archive(Stream)

Initialiserer en ny instans af Aspose.Zip.Lz4.Lz4Archive klasse forberedt til dekomprimering.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

kilden til arkivet.

Examples

Åbn et arkiv fra en strøm og uddrag det til en

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

Remarks

Denne konstruktør dekomprimerer ikke. Se Aspose.Zip.Lz4.Lz4Archive.Open metode til dekomprimering.

Exceptions

ArgumentException

Kan ikke læses fra sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

Den sourceStream’ har en forkerte underskrift.

Lz4Archive(String)

Initialiserer en ny instans af Aspose.Zip.Lz4.Lz4Archive klasse.

public Lz4Archive(string path)

Parameters

path string

Vejen til arkiveret.

Examples

Åbne et arkiv fra filen efter vej og uddrag det til en

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

Remarks

Denne konstruktør dekomprimerer ikke. Se Aspose.Zip.Lz4.Lz4Archive.Open metode til dekomprimering.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Anmelderen har ikke den nødvendige tilladelse til at få adgang

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

EndOfStreamException

Filen er for kort.

InvalidDataException

Data i filen har den forkerte underskrift.

Lz4Archive(Lz4ArchiveSetting)

Initialiserer en ny instans af Aspose.Zip.Lz4.Lc4Archivklasse forberedt til komprimering.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

Indstillingen af det samlede arkiv.

Methods

Dispose()

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

Dispose(Bool)

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Om de forvaltede ressourcer skal fjernes.

Extract(String)

Udveksler arkivet til filen ved vej.

public FileInfo Extract(string path)

Parameters

path string

Hvis filen allerede eksisterer, vil den blive overskrevet.

Returns

FileInfo

Information om en udvundet fil.

Exceptions

EndOfStreamException

Kildestrømmen er for kort.

InvalidDataException

Forkort byte fundet under dekodering.

NotSupportedException

Denne version af LZ4 er ikke understøttet.

Extract(Stream)

Udveksler arkivet til den leverede strøm.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. skal være skriftlig.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Kildestrømmen er for kort.

InvalidDataException

Forkort byte fundet under dekodering.

NotSupportedException

Denne version af LZ4 er ikke understøttet.

InvalidOperationException

Arkiverne er forberedt til komposition.

ExtractToDirectory(String)

Udveksler indholdet af arkivet til den leverede katalog.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Vejen til katalogen til at placere de udvundne filer i.

Remarks

Hvis katalogen ikke eksisterer, vil den blive oprettet.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.

SecurityException

Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.

NotSupportedException

Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“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, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.

EndOfStreamException

Kildestrømmen er for kort.

InvalidDataException

Den forkerte byte er fundet ved at initialisere dekodering.

InvalidOperationException

Arkiverne er forberedt til komposition.

Open()

bner arkivet til ekstraktion og giver en strøm med arkivindhold.

public Stream Open()

Returns

Stream

Den strøm, der repræsenterer indholdet af arkivet.

Examples

Udvider arkivet og kopierer udvundet indhold til 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 bruge Stream.CopyTo-metoden til .NET 4.0 og højere: unpacked.Kopier(udvundet);

Remarks

Læs fra strømmen for at få det oprindelige indhold af en fil. Se eksempler sektion.

Exceptions

EndOfStreamException

Kildestrømmen er for kort.

InvalidDataException

Den forkerte byte er fundet ved at initialisere dekodering.

InvalidOperationException

Arkiverne er forberedt til komposition.

Save(Stream)

Sparer lz4 arkiver til den leverede strøm.

public void Save(Stream output)

Parameters

output Stream

Destinationstrøm.

Examples

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

Remarks

Måske skal det søges.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Arkivet er forberedt til udvinding. - eller - Kilde blev ikke leveret.

Save(FileInfo)

Sparer lz4 arkiver til bestemmelsesfil, der er leveret.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, som vil blive åbnet som destinationstrøm.

Examples

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

Exceptions

SecurityException

Ringeren har ikke den nødvendige tilladelse til at åbne destination'.

ArgumentException

Filvejen er tom eller indeholder kun hvide rum.

FileNotFoundException

Filen er ikke fundet.

UnauthorizedAccessException

Vejen til filen er læst alene eller er en katalog.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

InvalidOperationException

Arkiverne er forberedt til udvinding.

Save(String)

Sparer arkiver til den foreløbige fil, der leveres.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Anmelderen har ikke den nødvendige tilladelse til at få adgang

ArgumentException

Den destinationFileName’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn.

UnauthorizedAccessException

Tilgang til filen destinationFileName’ er nægtet.

PathTooLongException

Den angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Fil på destinationFileName’ indeholder en kolonne (:) i midten af ringen.

InvalidOperationException

Arkiverne er forberedt til udvinding.

SetSource(Stream)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(Stream source)

Parameters

source Stream

Indtægtsstrøm for arkivet.

Examples

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

Exceptions

InvalidOperationException

Arkiverne er forberedt til udvinding.

SetSource(FileInfo)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Den reference til en fil, der skal komprimeres.

Examples

Åbn et arkiv fra en strøm og uddrag det til en

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

Exceptions

InvalidOperationException

Arkiverne er forberedt til udvinding.

SetSource(Fællesskab, TarFormat)

Indsæt indholdet til at blive komprimeret inden for arkivet.

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

Parameters

tarArchive TarArchive

Arkiverne skal komprimeres.

format TarFormat

Definition af 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

Brug denne metode til at komponere fælles tar.lz4 arkiv.

SetSource(String)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(string path)

Parameters

path string

Vejen til fil at blive komprimeret.

Examples

Åbne et arkiv fra filen efter vej og uddrag det til en

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Anmelderen har ikke den nødvendige tilladelse til at få adgang

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

InvalidOperationException

Denne arkiv er forberedt til udvinding.

 Dansk