Class XzArchive

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

objectXzArchive

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

ArgumentException

source är inte sökbar.

ArgumentNullException

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

ArgumentNullException

path är null.

SecurityException

Anroparen har inte den nödvändiga behörigheten för att få åtkomst.

ArgumentException

path är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till filen path är nekad.

PathTooLongException

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.

NotSupportedException

Filen på path innehåller ett kolon (:) i mitten av strängen.

FileNotFoundException

Filen hittades inte.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

IOException

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

InvalidOperationException

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

InvalidOperationException

Arkivhuvuden och tjänsteinformation lästes inte.

SecurityException

Anroparen har inte den nödvändiga behörigheten för att öppna fileInfo.

ArgumentException

Filens sökväg är tom eller innehåller endast vita tecken.

FileNotFoundException

Filen hittades inte.

UnauthorizedAccessException

Sökvägen till filen är skrivskyddad eller är en katalog.

ArgumentNullException

fileInfo är null.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

IOException

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

FileInfo

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

InvalidOperationException

Arkivhuvuden och tjänsteinformation lästes inte.

ArgumentNullException

path är null.

SecurityException

Anroparen har inte den nödvändiga behörigheten för att få åtkomst.

ArgumentException

path är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till filen path är nekad.

PathTooLongException

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.

NotSupportedException

Filen på path innehåller ett kolon (:) i mitten av strängen.

FileNotFoundException

Filen hittades inte.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

IOException

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

ArgumentNullException

destinationDirectory är null.

PathTooLongException

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.

SecurityException

Anroparen har inte den nödvändiga behörigheten för att få åtkomst till den befintliga katalogen.

NotSupportedException

Om katalogen inte finns, innehåller sökvägen ett kolontecken (:) som inte är en del av en enhetsetikett (“C:").

ArgumentException

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 (:).

IOException

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

ArgumentException

output stöder inte sökning.

ArgumentNullException

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

ArgumentNullException

destinationFileName är null.

SecurityException

Anroparen har inte den nödvändiga behörigheten för att få åtkomst.

ArgumentException

destinationFileName är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till filen destinationFileName är nekad.

PathTooLongException

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.

NotSupportedException

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

ArgumentException

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

SecurityException

Anroparen har inte den nödvändiga behörigheten för att öppna fileInfo.

ArgumentException

Filens sökväg är tom eller innehåller endast vita tecken.

FileNotFoundException

Filen hittades inte.

UnauthorizedAccessException

Sökvägen till filen är skrivskyddad eller är en katalog.

ArgumentNullException

fileInfo är null.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

IOException

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

ArgumentNullException

sourcePath är null.

SecurityException

Anroparen har inte den nödvändiga behörigheten för att få åtkomst.

ArgumentException

sourcePath är tomt, innehåller endast vita tecken eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till filen sourcePath är nekad.

PathTooLongException

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.

NotSupportedException

Filen på sourcePath innehåller ett kolon (:) i mitten av strängen.

 Svenska