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
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
Kan ikke læses fra sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
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
path’ is null.
Anmelderen har ikke den nødvendige tilladelse til at få adgang
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
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.
Filen på path’ indeholder en kolonne (:) i midten af ringen.
Filen er for kort.
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
Information om en udvundet fil.
Exceptions
Kildestrømmen er for kort.
Forkort byte fundet under dekodering.
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
destination’ does not support writing.
Kildestrømmen er for kort.
Forkort byte fundet under dekodering.
Denne version af LZ4 er ikke understøttet.
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
destinationDirectory’ is null.
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.
Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.
Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“C:”).
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 (:).
Den katalog, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.
Kildestrømmen er for kort.
Den forkerte byte er fundet ved at initialisere dekodering.
Arkiverne er forberedt til komposition.
Open()
bner arkivet til ekstraktion og giver en strøm med arkivindhold.
public Stream Open()
Returns
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
Kildestrømmen er for kort.
Den forkerte byte er fundet ved at initialisere dekodering.
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
output’ is null.
output’ is not writable.
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
Ringeren har ikke den nødvendige tilladelse til at åbne destination'.
Filvejen er tom eller indeholder kun hvide rum.
Filen er ikke fundet.
Vejen til filen er læst alene eller er en katalog.
destination’ is null.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er allerede åben.
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
destinationFileName’ is null.
Anmelderen har ikke den nødvendige tilladelse til at få adgang
Den destinationFileName’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn.
Tilgang til filen destinationFileName’ er nægtet.
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.
Fil på destinationFileName’ indeholder en kolonne (:) i midten af ringen.
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
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
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
path’ is null.
Anmelderen har ikke den nødvendige tilladelse til at få adgang
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
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.
Filen på path’ indeholder en kolonne (:) i midten af ringen.
Denne arkiv er forberedt til udvinding.