Class XzArchive
Namespace: Aspose.Zip.Xz
Assembly: Aspose.Zip.dll (25.1.0)
Denna klass representerar en xz-arkivfil. Använd den för att skapa och extrahera xz-arkiv.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Arv
Implementerar
IArchive, IDisposable, IArchiveFileEntry
Ärvda medlemmar
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktörer
XzArchive(XzArchiveSettings)
Initierar en ny instans av Aspose.Zip.Xz.XzArchive-klassen och skapar arkivet i xz-format.
public XzArchive(XzArchiveSettings settings = null)
Parametrar
settings
XzArchiveSettings
Mängd inställningar för det specifika xz-arkivet: ordboksstorlek, blockstorlek, kontrolltyp.
XzArchive(Stream)
Initierar en ny instans av Aspose.Zip.Xz.XzArchive-klassen för avkomprimering.
public XzArchive(Stream source)
Parametrar
source
Stream
Källan för arkivet.
Kommentarer
Denna konstruktor avkomprimerar inte. Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream)-metoden för avkomprimering.
Undantag
source
är inte sökbar.
source
är null.
XzArchive(string)
Initierar en ny instans av Aspose.Zip.Xz.XzArchive-klassen för avkomprimering.
public XzArchive(string path)
Parametrar
path
string
Sökväg till källan för arkivet.
Kommentarer
Denna konstruktor avkomprimerar inte. Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream)-metoden för avkomprimering.
Undantag
path
är null.
Anroparen har inte den nödvändiga behörigheten för att få åtkomst.
path
är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.
Åtkomst till filen path
är nekad.
Den angivna path
, filnamnet eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Filen på path
innehåller ett kolon (:) i mitten av strängen.
Filen hittades inte.
Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.
Filen är redan öppen.
Metoder
Dispose()
Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.
public void Dispose()
Dispose(bool)
Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.
protected virtual void Dispose(bool disposing)
Parametrar
disposing
bool
Om hanterade resurser ska frigöras.
Extract(Stream)
Extraherar xz-arkiv till en ström.
public void Extract(Stream destination)
Parametrar
destination
Stream
Ström för att lagra avkomprimerade data.
Exempel
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);
}
}
}
Undantag
Arkivhuvuden och tjänsteinformation lästes inte.
Extract(FileInfo)
Extraherar xz-arkiv till en fil.
public void Extract(FileInfo fileInfo)
Parametrar
fileInfo
FileInfo
FileInfo för att lagra avkomprimerade data.
Exempel
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Undantag
Arkivhuvuden och tjänsteinformation lästes inte.
Anroparen har inte den nödvändiga behörigheten för att öppna fileInfo
.
Filens sökväg är tom eller innehåller endast vita tecken.
Filen hittades inte.
Sökvägen till filen är skrivskyddad eller är en katalog.
fileInfo
är null.
Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.
Filen är redan öppen.
Extract(string)
Extraherar xz-arkiv till en fil via sökväg.
public FileInfo Extract(string path)
Parametrar
path
string
Sökväg till filen som kommer att lagra avkomprimerade data.
Returer
System.IO.FileInfo-instans som innehåller extraherade data.
Exempel
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Undantag
Arkivhuvuden och tjänsteinformation lästes inte.
path
är null.
Anroparen har inte den nödvändiga behörigheten för att få åtkomst.
path
är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.
Åtkomst till filen path
är nekad.
Den angivna path
, filnamnet eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Filen på path
innehåller ett kolon (:) i mitten av strängen.
Filen hittades inte.
Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.
Filen är redan öppen.
ExtractToDirectory(string)
Extraherar innehållet i arkivet till den angivna katalogen.
public void ExtractToDirectory(string destinationDirectory)
Parametrar
destinationDirectory
string
Sökvägen till katalogen för att placera de extraherade filerna.
Kommentarer
Om katalogen inte finns, kommer den att skapas.
Undantag
destinationDirectory
är null.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Anroparen har inte den nödvändiga behörigheten för att få åtkomst till den befintliga katalogen.
Om katalogen inte finns, innehåller sökvägen ett kolontecken (:) som inte är en del av en enhetsetikett (“C:").
destinationDirectory
är en sträng med noll längd, innehåller endast vita tecken eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp av metoden System.IO.Path.GetInvalidPathChars.
-eller- sökvägen är förprefixed med, eller innehåller, endast ett kolontecken (:).
Den angivna sökvägen är en fil. -eller- Det nätverksnamnet är okänt.
Save(Stream)
Sparar xz-arkivet till den angivna strömmen.
public void Save(Stream output)
Parametrar
output
Stream
Destinationström.
Exempel
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Kommentarer
output
måste vara sökbar.
Undantag
output
stöder inte sökning.
output
är null.
Save(string)
Sparar xz-arkivet till den angivna destinationsfilen.
public void Save(string destinationFileName)
Parametrar
destinationFileName
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil, kommer den att skrivas över.
Exempel
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Undantag
destinationFileName
är null.
Anroparen har inte den nödvändiga behörigheten för att få åtkomst.
destinationFileName
är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.
Åtkomst till filen destinationFileName
är nekad.
Den angivna destinationFileName
, filnamnet eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Filen på destinationFileName
innehåller ett kolon (:) i mitten av strängen.
SetSource(Stream)
Sätter innehållet som ska komprimeras inom arkivet.
public void SetSource(Stream source)
Parametrar
source
Stream
Indataström för arkivet.
Exempel
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Undantag
Strömmen source
är icke-sökbar.
SetSource(FileInfo)
Sätter innehållet som ska komprimeras inom arkivet.
public void SetSource(FileInfo fileInfo)
Parametrar
fileInfo
FileInfo
FileInfo som kommer att öppnas som indataström.
Exempel
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Undantag
Anroparen har inte den nödvändiga behörigheten för att öppna fileInfo
.
Filens sökväg är tom eller innehåller endast vita tecken.
Filen hittades inte.
Sökvägen till filen är skrivskyddad eller är en katalog.
fileInfo
är null.
Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.
Filen är redan öppen.
SetSource(string)
Sätter innehållet som ska komprimeras inom arkivet.
public void SetSource(string sourcePath)
Parametrar
sourcePath
string
Sökväg till filen som kommer att öppnas som indataström.
Exempel
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Undantag
sourcePath
är null.
Anroparen har inte den nödvändiga behörigheten för att få åtkomst.
sourcePath
är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.
Åtkomst till filen sourcePath
är nekad.
Den angivna sourcePath
, filnamnet eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Filen på sourcePath
innehåller ett kolon (:) i mitten av strängen.