Class XzArchive
Namn på plats: Aspose.Zip.Xz Sammanfattning: Aspose.Zip.dll (25.5.0)
Denna klass representerar xz arkivfilen. Använd den för att komponera och extrahera xz arkiv.
public class XzArchive : 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
XzArchive(XzArchiveSettings)
Initialiserar en ny instans av Aspose.Zip.Xz.XzArchivklassen och komponerar arkivet i xz-format.
public XzArchive(XzArchiveSettings settings = null)
Parameters
settings
XzArchiveSettings
Set av specifika xz arkiv inställningar: ordbokstorlek, blockstorlek, kontroll typ.
XzArchive(Stream)
Initialiserar en ny instans av Aspose.Zip.Xz.XzArchive klass förberedd för dekomprimering.
public XzArchive(Stream source)
Parameters
source
Stream
Källan till arkivet.
Remarks
Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metod för dekomprimering.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(Sträng)
Initialiserar en ny instans av Aspose.Zip.Xz.XzArchive klass förberedd för dekomprimering.
public XzArchive(string path)
Parameters
path
string
Vägen till källan till arkivet.
Remarks
Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metod 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 hittades inte.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
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(Stream)
Extract xz arkiv till en ström.
public void Extract(Stream destination)
Parameters
destination
Stream
Stream för lagring av dekomprimerade data.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(extractedFile);
}
}
}
Exceptions
Arkivhuvud och tjänsteinformation läses inte.
Extract(FileInfo)
Extract xz arkiv till en fil.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo för lagring av dekomprimerade data.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Arkivhuvud och tjänsteinformation läses inte.
Ringaren har inte tillståndet att öppna fileInfo'.
Filvägen är tom eller innehåller endast vita utrymmen.
Filen hittades inte.
Vägen till filen är läsbart eller är en katalog.
fileInfo’ is null.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
Extract(Sträng)
Extract xz arkiv till en fil per väg.
public FileInfo Extract(string path)
Parameters
path
string
Vägen till filen som kommer att lagra dekomprimerade data.
Returns
System.IO.FileInfo instans som innehåller extraherade data.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
Arkivhuvud och tjänsteinformation läses inte.
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 hittades inte.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
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.
Save(Stream)
Spara xz arkiv till den tillhandahållna strömmen.
public void Save(Stream output)
Parameters
output
Stream
Destination strömmar.
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Remarks
Måste vara sökbar.
Exceptions
output’ does not support seeking.
output’ is null.
Save(Sträng)
Spara xz arkiv till den avsedd filen.
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 XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
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.
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 XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
Strömmen av källan är inte sökbar.
SetSource(FileInfo)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo, som öppnas som input stream.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Exceptions
Ringaren har inte tillståndet att öppna fileInfo'.
Filvägen är tom eller innehåller endast vita utrymmen.
Filen hittades inte.
Vägen till filen är läsbart eller är en katalog.
fileInfo’ is null.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
SetSource(Sträng)
Ställ in innehållet för att komprimeras inom arkivet.
public void SetSource(string sourcePath)
Parameters
sourcePath
string
Vägen till filen som öppnas som input stream.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
Sökanden har inte behörig tillstånd att komma åt.
sourcePath’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen sourcePath’ vägras.
Den angivna sourcePath’, 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 sourcePath’ innehåller en kolumn (:) i mitten av raden.