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
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
Kan inte läsas från sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
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
path’ is null.
Sökanden har inte behörig tillstånd att komma åt
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
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.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Filen är för kort.
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
Information om en extraherad fil.
Exceptions
Källströmmen är för kort.
Felaktiga byter hittade under dekryptering.
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
destination’ does not support writing.
Källströmmen är för kort.
Felaktiga byter hittade under dekryptering.
Den här versionen av LZ4 stöds inte.
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
destinationDirectory’ is null.
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.
Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.
Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“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 som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.
Källströmmen är för kort.
Fel byter hittade medan initialisera dekryptering.
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
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
Källströmmen är för kort.
Fel byter hittade medan initialisera dekryptering.
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
output’ is null.
output’ is not writable.
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
Ringaren har inte nödvändig tillåtelse att öppna destination".
Filvägen är tom eller innehåller endast vita utrymmen.
Filen hittades inte.
Vägen till filen är läsbart eller är en katalog.
destination’ is null.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
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
destinationFileName’ is null.
Sökanden har inte behörig tillstånd att komma åt
destinationFileName’ är tom, innehåller endast vita utrymmen, eller innehåller ogiltiga tecken.
Tillgång till filen destinationFileName’ vägras.
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.
Filen i destinationFileName’ innehåller en kolumn (:) i mitten av raden.
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
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
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
path’ is null.
Sökanden har inte behörig tillstånd att komma åt
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
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.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Detta arkiv är förberett för utvinning.